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PREFACE 



This manual provides reference information for 
the CDC® Matrix Algorithm Processor III (MAP III) 
System, which consists of a microprogrammable 
processor called MAP and a software package 
called the MAP System Software Interface (MSSI). 
The MAP III system provides an efficient way for 
user FORTRAN programs to perform lengthy array 
calculations. 

The MAP III system interfaces with the following 
extended core storage - equipped computer 
systems running under CDC NOS or NOS/BE 
operating systems. 

• CDC 6000 series. 

• CDC CYBER 70 models 72/73/74. 

• CDC CYBER 170 series. 

This manual is written primarily for FORTRAN 
(FTN) programmers and computer operators who 
use the MAP III system. Refer to the following 
table for supplementary and related documents. 

The following conventions are used in this manual. 



All numbers are decimal unless another 
base is indicated. 

Logical zero and one are abbreviated 
and 1, respectively. 

Bits are numbered from right to left 
beginning with 0. 

( ] enclose optional FORTRAN call 
arguments. 

. . . indicates preceding pattern repeats 
indefinitely. 



The following articles describe the algorithms 
underlying the fast Fourier transform (FFT) 
macros described in section 3. The basic FFT 
algorithm first appeared in article 1. Article 2 
discusses many details relevant to the MAP 
implementation of the algorithm. The time-saving 
and space-saving variations used for the 
REALFFT and INVRFFT macros are discussed on 
page 65 of article 3. 

1. J. W. Cooley and J. W. Tukey, "An 
Algorithm for the Machine Calculation of 
Complex Fourier Series," Mathematics 
of Computation, vol. 19, pp. 297-301, 
April, 1965. 

2. G-AE Subcommittee on Measurement 
Concepts (W. T. Cochran, et. al.), 
"What is the Fast Fourier Transform?". 

IEEE Transactions on Audio and 
Electroacoustics, vol. AU-15, pp. 45-55, 
June, 1967. 

3. C. Bingham, M. D. Godfrey, and 

J. W. Tukey. "Modern Techniques of 
Power Spectrum Estimation", IEEE 
Transactions on Audio and Electro- 
acoustics, vol. AU-15, pp. 56-66, 
June, 1967. 



DISCLAIMER 

The MAP III system is intended for use only as 
described in this manual. Control Data cannot be 
responsible for the proper functioning of undescribed 
features or parameters. 
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CONTROL DATA, MAP III DOCUMENTS 



Document 



ECL 10000 Series Circuit 
Description Manual 

MAP Hardware 
Maintenance Manual 

MAP III Installation 
Handbook (NOS) 

MAP III Installation 
Handbook (NOS /BE) 

NOS Programmer's 
Maintenance Aid, CYBER 
MAP III Software 

NOS /BE Programmer's 
Maintenance Aid, CYBER 
MAP III Software 

6000 MAP in Controlware 
External Reference 
Specification (ERS) 

MAP III On-Line Controlware 
ERS 

6000 MAP III Assembler 

ERS 

MAP III Command 
Diagnostics ERS 

MAP III Memory Test 
(QMM) ERS 

MAP in Test Functional 
Units (TFU) ERS 

MAP III System Confidence 
Test (QM3) ERS 



Typet 



Controlled 60417700 

Controlled 60429100 

Uncontrolled 
Uncontrolled 
Uncontrolled 

Uncontrolled 22836700 



Uncontrolled 



Uncontrolled 



Uncontrolled 



Uncontrolled 



Uncontrolled 



Uncontrolled 



Uncontrolled 



Part No. 



12104400 



12104300 



12104200 



12104100 



22836600 



12103900 



User 



Customer 
engineer 

Customer 
engineer 

System 
programmer 

System 
programmer 

System 
programmer 

System 
programmer 

System 
programmer 

System 

programmer 

Controlware 
programmer 

Customer 
engineer 

Customer 
engineer 

Customer 
engineer 

Customer 
engineer 



Purpose 



Describes MAP III logic elements 
and related symbology. 

Provides MAP III hardware 
maintenance information. 

Describes MSSI installation 
procedure for NOS. 

Describes MSSI installation 
procedure for NOS /BE. 

Defines MSSI internal structure 
for NOS. 



Defines MSSI internal structure 
for NOS /BE. 



Defines external interface to 
MAP III internal controlware. 



Describes additional controlware 
macros. 

Describes assembler used to 
generate internal controlware. 

Describes MAP III control unit 
diagnostics. 

Describes MAP III data storage 
diagnostics. 

Describes MAP III functional unit 
diagnostics. 

Describes diagnostics used to 
confirm normal MAP III system 
operation. 



tControl Data is not responsible for the contents of uncontrolled documents. 
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MAP III SYSTEM 



This section describes MAP and MSSI, which are 
the hardware and software elements, respectively, 
of the MAP III system. 



MAP 

The hardware element of the MAP III system is 
Matrix Algorithm Processor III (MAP), a micro- 
programmable array processor containing its own 
data storage. MAP uses a 32-bit floating-point 
format for arithmetic calculations and contains a 
numerical conversion unit to translate various 
computer system data formats to the 32-bit format. 

Microcode that resides within MAP is called 
controlware. Although MSSI supplies default 
controlware that provides standard MAP capabil- 
ities, controlware options are available to 
increase these capabilities. Appendix B lists 
standard and optional MAP capabilities and asso- 
ciated macros. 

The user controls MAP with macro strings, each 
of which is a collection of macros assembled and 
loaded into MAP by means of MSSI. Generally 
speaking, a macro is a symbol representing the 
microcode for performing a specific task or 
algorithm. For example, the HALT macro 
represents the microcode that stops macro exe- 
cution, the LOADP32 macro represents the micro- 
code that transfers packed data from extended core 
storage (ECS) to MAP, and the SUMPKOD macro 
represents the microcode that performs a sum of 
products calculation. From the user's point of 
view, MAP executes a macro string as a computer 
executes a program. 



MAP CABINET 

Figure 1-1 shows the MAP cabinet, which includes 
a power bay, a logic bay, and an optional memory 
bay. Operating controls are in the power and 
logic bays, and input/output cables connect to the 
logic bay. 



OPTIONS 



Figure 1-2 shows the options that can be added to 
MAP. 



Data storage options permit MAP data 
storage to be expanded from its minimum 
size of 24 Kf to its maximum size of 
256 K. 

Additional arithmetic units reduce pro- 
cessing time for certain algorithms. For 
example, MAP performs sum-of-products 
calculations most rapidly when equipped 
with four add /subtract units and four 
multiply units. Controlware must be 
modified when arithmetic units are added. 




POWER 
BAY 



LOGIC 
BAY 



MEMORY 

BAY 

(OPTIONAL) 

Figure 1-1. MAP Cabinet 

Figure 1-3 shows the minimum MAP configuration 
necessary to support MSSI. 



Tl K = 1024 words. 
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Figure 1-2. Basic MAP and Options 
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Figure 1-3. Minimum MAP Configuration for MAP III System 
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DATA FORMAT 

Figure 1-4 shows the MAP internal data format. 



31,30 


2* 23 









f J 


, 


A 
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, 








EXPO 


MENT 




MANTISSA 





SIGN RADIX POINT 



Figure 1-4. MAP Internal Data Format 



memory and are used to sequence microcode 
execution. The user generates macro strings by 
using the FORTRAN subroutine calls described in 
section 2. The 6000 MAP III Assembler ERS 
listed in the preface describes the special assem- 
bler used to generate controlware. 



Arithmeti c 

This area contains arithmetic units and the buses 
that transfer operands /results between data stor- 
age, the arithmetic units, and the numerical con- 
version unit. Figure 1-2 shows the number and 
types of arithmetic units that can attach to MAP. 



The format consists of a 24-bit normalized man- 
tissa, a 7-bit, signed twos complement exponent, 
and a sign bit using sign and magnitude repre- 
sentation. The exponent represents powers of 2. 

The range for positive normalized internal floating- 
point format MAP numbers is from 2" t0l ^8 to 
0.77777777s ' 2 77 8. The smallest and largest 
decimal numbers (7 significant digits) in this 
range are 0.5421011 * 10-19 an d 0.9223371 • 
10 + i9. All positive fixed-point numbers not 
exceeding 2^4 (16,777,216) can be represented 
exactly in internal format. 



FUNCTIONAL DESCRIPTION 

Figure 1-5 shows MAP functional areas. 



Data Storage 

Data storage contains from 24 K to 256 K of 32 -bit 
storage in three contiguous sections labeled x, y, 
and z. Maximum sizes for sections x, y, and z 
are 96 K, 96 K, and 64 K, respectively. Hard- 
ware switches specify the boundaries between 
sections so that addresses are continuous from the 
first word of section x to the last word of section 
z. 

Data storage is equipped with three accesses, 
labeled A, B, and C. Since each access can read 
from or write to any nonbusy section, up to three 
data storage operations can proceed simultaneously. 
Thus, two accesses can read operands while, at 
the same time, the third stores a result. 



Input/Output 

During MAP input, the input /output area accepts 
ECS, peripheral processor (PP), or cassette 
data; passes it through the assembly /disassembly 
unit; and places the data on the assembly/disas- 
sembly bus. From here, the data can transfer 
directly to the control area or indirectly to data 
storage through the numerical conversion unit and 
the result bus. During MAP output, dataflow 
reverses except that data returns from data 
storage to the assembly/disassembly bus through 
operand bus 2 and the numerical conversion unit. 



Control 

The control area executes controlware and macro 
strings. Controlware determines how MAP pro- 
cesses each algorithm and resides in control 
memory, read-only memory (ROM), and sub- 
control memory. Macro strings reside in macro 



MSSI 

The software element of the MAP III system is the 
MAP System Software Interface (MSSI), a collection 
of COMPASS programs, FORTRAN routines, and 
MAP controlware that coordinates with the NOS or 
NOS/BE operating system. MSSI allows the user 
to: 

• Generate macro strings for calling a 
series of MAP-resident algorithms into 
execution. 

• Transfer controlware and macro strings 
to MAP. 

• Monitor MAP status. 

• Print MAP dump information. 

MSSI also provides a repertoire of commands and 
messages that allows an operator to control the 
MAP III system from the system console. Section 
5 describes these commands and messages. 
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Figure 1-5. MAP Functional Entities 
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USER CONTROL 

A user employs the MAP III system by writing a 
FORTRAN program that: 

• Places operands in ECS. 

• Generates a macro string that instructs 
MAP to obtain the operands from ECS, 
process them, and return results to ECS. 

• Removes the results from ECS for output 
or further processing. 

To simplify MAP-related programming, MSSI pro- 
vides a set of execution time FORTRAN routines 
called the Macro String Assembly Module (MSAM). 
By making calls to these routines, a user program 
can build a macro string and also accommodate 
ancillary macro string requirements. 

The following sequence shows tasks performed by a 
typical MAP-related program. Parentheses enclose 
MSAM-provided calls, which are described in 
section 2 along with the macro string format. 
Section 4 contains examples of MAP-related 
programs . 

1. Declare file OUTPUT in PROGRAM state- 
ment. 

2. Define parameters and data arrays to re- 
side in central memory and ECS, 

, respectively. 

3. Open MAP environment table (MET). The 
MET is a table used for communication 
between MSSI and the operating system. 
(METOPEN) 

4. Clear buffer area used to build macro 
string. (MAPSET) 

5. * Define MAP data storage arrays. (MALLOT, 

MEQUIV) 

6. Define common macro parameters. 
(MPARAM) 

7. Use MACRO calls to build macro string. 

a. Transfer operands from ECS to MAP 
with LOADxxx macro. 



c. Transfer results from MAP to ECS 
with UNLDxxx macro. 

d. Stop macro string execution with HALT 
or END macro. 

8. Pack macro string. (MAPNOGO) 

9. Execute macro string. (MAPGO) 

10. Allow for MAP-related program recall. 
(MAPGO call argument or MRECALL call) 

11. Release ECS dump area. (MDRLSE) 

12. Close MET. (MCLOSE) 

13. Process or output results. 

14. Terminate MAP-related program. 



JOB SEQUENCE 

Figure 1-6 shows a user program in the MSSI 
environment. A typical MAP III system job pro- 
ceeds as follows: 

1. The user program begins execution and 
calls MSAM routines to initialize tables, 
prepare a macro string, and request macro 
string execution. User program activity 
may suspend either immediately after the 
request or after additional processing. 

2. After MSSI has scheduled the macro string 
and ensured that the correct controlware 
is loaded, the macro string transfers from 
central memory to MAP and begins 
execution. 

3. MSSI records MAP status during macro 
string execution. When the macro string 
completes execution or a fatal error 
occurs, MSSI places the user program 
back in execution after updating timing/ 
error tables. 



b. Use arithmetic macros (REALFFT, 
ADDVEC, and so on) to perform cal- 
culations and use control / pseud o 
macros (TMM, JUMP. RJUMP, UPM) 
to perform tests, jumps, and updates. 
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Figure 1-6. MSSI Environment 
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MACRO STRING ASSEMBLY 



This section describes macro string formats, Macro 
String Assembly Module (MSAM) status, and 
FORTRAN calls provided by MSAM. The macro 
string formats are described here chiefly for refer- 
ence purposes, since MSAM automatically builds 
and packs macro strings according to calls from 
user programs. 

Appendix B contains an MSAM call summary. 
Section 4 describes the LOCE function (used to 
obtain the address of an ECS-resident variable) and 
provides programming considerations applicable to 

MSAM. 



MACRO STRING 

Figures 2-1 and 2-2 show the same macro string in 
unpacked and packed formats, respectively. MSAM 
uses the unpacked format while building a macro 
string, and then packs the macro string before send- 
ing it to MAP for execution. 

Each macro string has a header, a macro field, and 
a parameter field. MSAM builds the macro field 
from the top down and the parameter field from the 
bottom up. Parameters within a block remain in 
user-assigned order, regardless of the position of 
the block in the parameter field. 



HEADER 

Before packing a macro string, MSAM uses the 
header as a scratch area for maintaining data neces- 
sary to complete the macro string. After packing 
the macro string, MSAM rewrites the header with 
the information shown in figure 2-2. When it trans- 
fers the macro string to MAP, the MAP PP driver 
replaces the word count and checksum in the header 
with RA (x), the relative address of MAP data 
storage section x. 



MACRO FIELD 

In unpacked form, each 60-bit word of the macro 
field contains a macro code in bits through 17 and 
space for a tag in bits 18 through 59. A macro code 
is an 18-bit number associated with a macro. For 
example, the macro code for the NOOP macro is 
02O0O0 8 . MACRO call arguments determine the 
placement of macro codes and tags as follows: 

• A MACRO call with for the tag argument 
places the macro code for the macname 
argument in bits through 17 of a macro 
field word. When the call has a nonzero 
paraddr argument, the call places the 
parameter address for the paraddr argu- 
ment in the next macro field word. 



• A MACRO call with a 4L JUMP or 5LR JUMP 
macname argument places the appropriate 
macro code in bits through 17 of a macro 
field word, and places the paraddr argu- 
ment in bits 18 through 59 of the same word 
(figure 2-1, word 14). 

• A MACRO call with a nonzero tag argu- 
ment generates code in two or three words 
and is used to begin macro string segments 
that will be entered with RJUMP macros. 

The first word contains the macro code for 
a NOOP macro (020000„) in bits through 
17 and the tag argument: (with the leftmost 
bit unconditionally set) in bits 18 through 59 
(figure 2-1, word 11). This reserves a 
word for storing a return address and the 
macro code for a JUMP macro. 

The second word contains the macro code 
for the macname argument in bits through 
17 (figure 2-1, word 12). 

A third word contains the parameter ad- 
dress if the MACRO call had a nonzero 
paraddr argument (figure 2-1, word 13). 

MSAM automatically loads the first word of each 
macro field (word 6) with a HALT macro (100000 ) 
labeled - INIS. The END macro places in the 8 
macro string a JUMP macro that transfers control 
to the HALT macro at word 6 . 



PARAMETER FIELD 

In unpacked form, each 60-bit word of the param- 
eter field contains a parameter value or a pointer 
to a parameter value in bits 0. through 17, and space 
for a tag in bits 18 through 59. Upon receipt of a 
MACRO call, MSAM examines the macname argu- 
ment and determines the parameter count for the 
macro. MSAM then searches for the parameter 
location specified by the paraddr argument, trans- 
fers the parameter to the parameter field, and 
continues transferring subsequent parameters until 
the parameter count is satsified. 

MSAM does not satisfy indirect references to 
parameter values (that is, values tagged by 
MPARAM calls) until the macro string is packed. 

When it knows that a parameter specifies a data 
storage address, MAP examines parameter bits 10 
and 11 for (section x), 1 (section y), or 2 (section 
z). MAP determines the address by adding the 
contents of header word 0, 1, or 2 to the contents 
of the parameter field word specified by bits 
through 9 of the parameter. 
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2.-1 



Word 



59 



-It 



1 

2 

3 

4 

5 

6 

7 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 
32 
33 
34 



18 17 



0-»-Bit 



MSAM Scratch 
Area 




I N I S 
LOOP 
FINIS 

OOP 

LOOP 


10 
4 
2 
2 
4 3 2 2 
2 1 
2 


Unused 




X A R R A Y 
COMMON 

8 O M M O N 


1 
1 
17 5 
3 4 

1 


17 6 
1 

17 7 7 7 7 



Header 



Macro 
Field 



Parameter 
Field 



tThe first word is considered - 1 as it is not packed or loaded into macro memory. 
Figure 2-1. Unpacked Macro String Buffer 
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1 


59 







„ gj t 


-1- 


h MS AM Header Information 







CM Word 
Count 


Checksum RA(Y) 


RA(Z) 1 


Header 


1 


RA(Z)2 


LWA(X) 


LWA(Y) 




2 


— LWA(z) vzzzz/, > o o o o 


o Z///Z, o «' 


) 


3 


11 


'/ZZZZ/.z o 6 ^^0 


2 


1 Macro 


4 


'ZZZZZ 4 0322 '/////, 00002 


1 Z////, 2 







° ° i imm^^zzz/zzzz//^ 


#ii« 




■6 


^/zzzzzzzJ/zzzzz///////////^^ oioo vz/jm r 


■ 


7 


o 2 ^^ 1 ZZZZZ o 


17 5 




10 


W/ 3 4 0^ 


«W//,± o 


Field 


11 


o 3 4^%0 o o ZZZZo 







12 


'Z//Z* 17 6 0k/////0 


i ^ .o o 




13 


oooo y/ZzZA 1 7 77 7 7 | 






14 
15 
16 
17 
20 
21 
22 
23 
24 
25 


Unused/unpacked pata 






26 








27 








30 








31 








32 








33 








34 









tThe first word is considered -1 as it is not packed or loaded into macro memory. 
Figure 2-2. Packed Macro String Buffer 
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EXECUTION SEQUENCE 

All macro strings begin execution at word 7. The 
macro string shown in figures 2-1 and 2-2 executes 
as follows: 



1. 



3. 
4. 
5. 
6. 



Execution begins at word 7 with an RJUMP 
macro that loads a return address (10) and 
JUMP macro in =OOP and then transfers 
control to =OOP+l. =OOP is the tag argu- 
ment (with the leftmost bit set) of the 
MACRO call that placed the LOADL32 
(400322g) macro in word 12. 

The LOADL32 macro causes MAP to fetch 
the parameter block whose address is at 
word 13, perform the load operation, and 
return control to the JUMP macro at word 
14. 

The JUMP macro at word 14 transfers 
control to =OOP. 

=OOP now contains a JUMP macro that 
transfers control to word 10. 

Word 10 contains a JUMP macro that 
transfers control to -INIS. 

-INIS contains a HALT macro that stops 
execution. 



MSAM STATUS 



Each MSAM call (except MDUMF and MDRLSE) has 
a status argument that specifies a location to receive 
MSAM status. Since MSAM does not clear the 
status word, the user program should clear the 
status word after each MSAM call unless cumulative 
status is desired. MSAM status bits are defined as 
follows : 



Bit(s) 

0,1 

2 
3 



5 
6 
7 
8 
9 
10 

11 
12 

13 

14 

15 
16 
17 

18 



Description 

Unused. 

Illegal array name. 
No controlware address; assume de- 
fault controlware. 

No controlware name; assume default 
controlware. 
MET undefined. 
MET closed. 

Macro string buffer too small. 
Symbol defined twice. 
Unused. 

Array overflow into previously defined 
field. 

Base array undefined. 
Equivalent array exceeds base array 
field length. 

Undefined or previously packed macro 
string. 

Undefined macro. 

Illegal data in macro parameter field. 
MAP not available. 

Macro string executed through different 
MET (informative). 
Array overflows x data storage 
(informative). 



Bit(s) 

19 

20 
21 
22 
23 
24 

25 
26 



27 

28 
29 

30-59 



Description 

Array overflows y data storage 
(informative). 

Array overflows z data storage. 
Undefined label. 

MCLOSE attempted on closed MET 
MSAM call error. 

Macro string buffer too large; assume 
macro memory size plus 1. 
METOPEN attempted on open MET. 
Parameter block contains indirect 
parameter reference or illegal param- 
eter (informative). 

Indirect parameter block too large for 
macro string buffer. 
Illegal macro label. 

ECS unload array last word address not 
multiple of 8. 
Unused. 



An installation parameter classifies MSAM status 
bits as fatal or nonfatal. The user program aborts 
when MSAM detects an invalid argument count or 
when MSAM detects more fatal errors than allowed 
by the errlim argument of the METOPEN call 



MSAM CALLS 

The following calls allow user programs to control 
the MAP III system. 



METOPEN 

Establishes MAP environment table (MET) within 
user's field length. MET contains pointers, code/ 
status values, and error information used by MAP 
PP driver and central processor monitor. A user 
program can define more than one MET, and more 
than one macro string can be associated with the 
same MET. Figure 2-3 shows MET format. 

When user specifies new controlware, METOPEN 
transfers controlware to ECS and records ECS 
address of controlware in MET. Refer to 6000 
MAP III Assembler ERS listed in preface for control- 
ware structure. 

Sequence: 

CALL METOPEN (met, symtable, control- 
ware, conaddr, status [, errlim]) 



met 



MET name. 



symtable Symbol table name. 

controlware (use default controlware) 
or left-justified, zero-filled 
name of local file containing 
user-supplied controlware. 

conaddr (default controlware) or 

destination ECS address 
(within user's field length) 

for user- supplied control- 
ware. 
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status Location to receive MSAM 

status. 

errlim Number of fatal assembly 

errors allowed before 
aborting job. 



Examples : 

CALL METOPEN (MET 1, SYM, 0, 0, STAT (1), 2) 

CALL METOPEN (MET2, ARRAYS, 5LMYLIB, 
LIBLOCST) 



- DEFAULT 

CONTROLWARE 

1 - USER 

CONTROLWARE 



- NORMAL 

TRANSFER 

1 - SPECIAL 

CHANNEL 
TRANSFER 



- USER 

PROGRAM 

1 - ONLINE 

DIAG- 
NOSTIC 



NOS 



I 59 

• En 



5 57 
8 



JOB NAME 



ESTIMATED 
TIME 



MACRO 

STRING 

ADDRESS 



ERROR 

TABLE 

ADDRESS 



TIMING 
TABLE 
ADDRESS 



SYMBOL 

TABLE 

ADDRESS 



4 



t 



33 \22 

MAP \ 

PRIORITY x 



17 9 

GLOBAL 
ERRORS 



CODE/ 
STATUS 



ECS 

CONTROLWARE 

ADDRESS 



FATAL ERROR BITS 



UNCONDITIONAL DUMP 



59 SO 

ERROR 
LIMIT 



UNCONDITIONAL NO DUMP 



X FL 
(TOTAL) 



Y FL 
(TOTAL) 



Z FL 
(TOTAL) 



MACRO 

FL 
(TOTAL) 



WORD 
1 



NOS/BE 



ERROR 
LIMIT 



Figure 2-3. MET Format 
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MAPSET 



MEQUIV 



Zero-fills macro string buffer and restores header 

information. 

Sequence: 

CALL MAPSET (met, macbuf, length, status) 

met MET for this macro string. 

macbuf Macro string buffer name. 

length Number of words in macro 

string buffer. 

status Location to receive MSAM 

status. 

Example: 

CALL MAPSET (METBUF, STRING, 100, STAT) 

MALLOT 

Defines and assigns name to MAP data storage 
array, thereby enabling macro string parameters 
to reference array by name. Individual array ele- 
ments may be referenced by subscript in same 
manner as individual parameters in tagged param- 
eter block (refer to MPARAM call description). 

Sequence: 

CALL MALLOT (met, aryname, maplen, 0, mem, 
status ) 

met MET name. 

aryname Left- justified, zero-filled 

array name (one to seven 
characters, first must be 
alphabetic). 

maplen Number of elements in array. 

Required, but unused. 

mem lLn where n is section 

(x, y, z) of MAP data storage 
to store first word of array. 

status Location to receive MSAM 

status. 



Examples : 



CALL MALLOT (MET2, 6LARRAY1, 
1000, 0, 1LX,STAT(6)) 

CALL MALLOT (MYMET, 6LFILTER, 
FTLEN, 0, 1LZ, ERRORS) 



Defines and assigns name to array within previously 
defined MAP data storage array. New array must 
not extend beyond last word of previously defined 
array. 

Sequence: 

CALL MEQUIV (met, equivname, maplen, 
basearray, offset, status) 



met 
equivname 

maplen 
basearray 

offset 

status 



MET name. 

Left-justified, zero-filled, 
new array name (one to seven 
characters, first must 
be alphabetic). 

Number of elements in new 
array. 

Previously defined array 
name. 

Number of locations between 
first element of previously 
defined array and first ele- 
ment of new array. 

Location to receive MSAM 
status. 



Examples : 



CALL MEQUIV (JOBMET, 3LIAA, 200, 2LIA, 800 
STATUS) 

CALL MEQUIV (MYMET, 6LCOSINE, 512 
4LSINE, 256.STATU2)) 



MACRO 

Places macro and associated parameters into macro 
string. 



Sequence: 



CALL MACRO (macstr, tag, macname, paraddr, 
status) 

macstr Macro string name. 

tag Unused (0) unless macname 

begins a macro sequence 
entered by an RJUMP or 
JUMP macro, in which case 
tag is a left- justified, zero- 
filled label (one to seven 
characters, first must 
be alphabetic) for a NOOP 
macro used to reserve the 
location immediately pre- 
ceding the location to hold 
macname. 
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macname 



paraddr 



status 



Left justified, zero-filled 
macro mnemonic. 

Unused (0) for NOOP, HALT, 
and END macros. 

Jump address for JUMP or 
RJUMP macros. 

Name of first parameter 
for other macros. 

Location to receive MSAM 
status. 



Examples : 



CALL MACRO (MACS, 0, 6LFILTER, PS(1), 
ST(10)) 

CALL MACRO (STRING1, 4LLOOP, 7LLOADP32, 
PARS(l), ERRS) 

CALL MACRO (STRING1, 0, 5LRJUMP, 4LLOOP, 
ERRS) 

CALL MACRO (MACSTR, 0, 3LEND, 0, ST) 



59 



30 29 



Number of 6 0-bit words 
between macro string 
word and word contain- 
ing all or part of first 
parameter. 



Right- justified, end- 
around, left- shift count 
that right- justifies first 
parameter in 60-bit 
word. When left-shift 
count is 12, parameter 
bits through 11 are in 
bits 48 through 59 of the 
word and parameter bits 
12 through 18 are in bits 
through 5 of the previous 
word. 

Examples : 



CALL MPARAM (MAC1, 7LADMASK1, 177777B, 
i, STATU5)) 

CALL MPARAM (MS2, 7LNPOINTS NPTS 1 
ERRS, PACKADD) 

CALL MPARAM (STRING, 6LCOMMON, COM(l) 
6, ST) 



MPARAM 

Assigns name to and places common parameter 
block in macro string. When block contains more 
than one parameter, second through last parameters 
may be referenced by subscripting parameter name 
using . OR. expression. For example, second 
parameter in block tagged 6LCOMMON can be 
referenced as 6LCOMMON. OR. 2. 

Sequence: 

CALL MPARAM (macstr, tag, value, length, 
statusf, loc]) 



macstr 



value 

length 
status 
loc 



Macro string name. 

Left-justified, zero-filled 
label (one to seven charac- 
ters, first must be alpha- 
betic) by which parameter 
block is referenced. 

First value in parameter 
block, value must not be 
an array name or the name 
of a parameter block. 

Number of parameters in 
block. 

Location to receive MSAM 
status. 

(Optional) Location to receive 
position of first parameter in 
packed macro string. 
Interpret loc contents as 
follows: 



MAPNOGO 

Satisfies macro string tag references and packs 
macro string, but does not request macro string 
execution. 

Sequence : 

CALL MAPNOGO (met, macstr, status[, ref]) 

met MET name. 

macstr Macro string name. 

status Location to receive MSAM 

status. 

ref (Optional) Argument (any 

value) that returns symbol 
table and data storage map 
in program listing (refer to 
Example Programs in 
section 4). 

Examples : 

CALL MAPNOGO, (MET3, STRING, ERR) 

CALL MAPNOGO, (MYMET, MAC, STAT, 1) 
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MAPGO 

Requests macro string execution. If macro string 
is not packed, MAPGO satisfies macro string tag 
references and packs macro string before requesting 
execution. 

Sequence: 

CALL MAPGO (met, macstr, timtable, errtable, 
recall, estime, status[, febits]) 



TABLE 2-1. MAP STATUS WORDS 



met 

macstr 

timtable 

errtable 

recall 



estime 



status 



febits 



MET name. 

Macro string name. 

Timing table name (refer to 
section 4) or 7LNOTABLE 
if no table is desired. 

Error table name (refer to 
section 4) or 7LNOTABLE 
if no table is desired. 

Nonzero: Suspend program 
execution until macro string 
completes execution. 

0: Continue program 
execution. 

Estimated macro string 
execution time in milli- 
seconds, estime must not 
exceed maximum time set 
by installation parameter. 

Location to receive MSAM 
status. 

(Optional) 48-bit pattern 
plus dump bit corresponding 
to four MAP status words 
described in table 2-1. MAP 
status bits having corre- 
sponding febits bits set are 
defined as fatal error bits. 
Bit 48 of febits causes MAP 
PP driver to transfer MAP 
data storage to ECS dump 
area after macro string 
completes execution. De- 
fault febits pattern defines 
each MAP status bit as fatal 
and specifies that no dump 
occur. 



Examples : 



CALL MAPGO (MET1, MS2, TIM, ERR, 0, 
ESTIME, STAT) 

CALL MAPGO (MET, STRING, 7LNOTABLE, 
7LNOTABLE, 1LR, EST, ST(17), 
17777010406170007B) 



MAP 
Status 
Word 


febits 
Bit 


Description 


Memory 
error 




1 

2 

3 

4 
5 
6 

7 

8 

9 
10 
11 


Data storage access A parity 

error. 

Data storage access B parity 

error. 

Data storage access C parity 

error. 

Subcontrol memory parity 

error. 

Control memory parity error. 

Macro memory parity error. 

Access A address out of 

range. 

Access B address out of 

range. 

Access C address out of 

range. 

ECS parity error. 

ECS abort. 

ECS field length error. 


Arithmetic 
error 3 


12 
13 
14 

15 

16 
17 
18 
19 
20 
21 
22 
23 


Negative square root (unit 1). 

Negative square root (unit 2). 

Numerical conversion unit 

overflow. 

Numerical conversion unit 

underflow. 

Unused. 


Arithmetic 
error 2 


24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 


Overflow in multiply unit 1. 
Overflow in multiply unit 2 . 
Overflow in multiply unit 3 . 
Overflow in multiply unit 4. 
Underflow in multiply unit 1 . 
Underflow in multiply unit 2. 
Underflow in multiply unit 3. 
Underflow in multiply unit 4. 
Overflow in divide unit 2. 
Underflow in divide unit 2. 
Divide by 0, divide unit 2. 
Divide by 0, divide unit 2. 


Arithmetic 
error 1 


36 
37 
38 
39 
40 

41 

42 

43 

44 
45 
46 
47 


Overflow in add/subtract unit 1. 

Overflow in add/subtract unit 2. 

Overflow in add/subtract unit 3. 

Overflow in add /subtract unit 4. 

Underflow in add/ subtract 

unit 1. 

Underflow in add /subtract 

unit 2. 

Underflow in add/subtract 

unit 3. 

Underflow in add /subtract 

unit 4. 

Overflow in divide unit 1 . 

Underflow in divide unit 1. 

Divide by 0, divide unit 1. 

Divide by 0, divide unit 1. 
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TABLE 2-1. MAP STATUS WORDS (Contd) 


MAP 






Status 


febits 




Word 


Bit 


Description 




48 
49 
50 
51 
52 


Unconditional dump flag. 




53 
54 
55 
56 
57 
58 
59 


Unused. 



MODIFY 

Replaces first value of MPARAM-defined common 
parameter block with new value, then recomputes 
checksum and stores new checksum in header. 

Sequence: 

CALL MODIFY (macstr, loc, value, status) 



macstr 
loc 

value 



status 



Macro string name. 

Parameter position returned 
to location specified by loc 
argument of MPARAM call. 

New value for parameter. 
Relative ECS limit addresses 
for ECS load /unload macros 
should be adjusted as follows: 

ECS load macro: Add 48 to 
value and increment result 
until result is multiple of 8. 

ECS unload macro: Add 1 to 
value and increment result 
until result is multiple of 8. 

Location to receive MSAM 
status. 



Examples : 

CALL MODIFY (CHGMAC, WORD, NEWVAL, ST) 
CALL MODIFY (MAC, RET, 177777B, STAT<6)) 

MCLOSE 

Ensures that MAP activity associated with MET is 
complete, closes MET, and clears schedule table 
entry associated with MET. 



Sequence: 

CALL MCLOSE (met, status) 
met MET name. 



status 



Location to receive MSAM 
status. 



Example : 

CALL MCLOSE (MET2, ST(25)) 

MRECALL 

Suspends program execution until MAP finishes 
processing macro string. 

Sequence: 

CALL MRECALL (met, status) 

met MET name. 



status 



Location to receive MSAM 
status. 



Example: 

CALL MRECALL (MYMET.ERRS) 

MRESET 

Reinitializes symbol table for MET so that previously 
packed and newly generated macro strings can exe- 
cute from same MET. 

Sequence: 

CALL MRESET (met, status) 

met MET name. 



status 



Location to receive MSAM 
status. 



Example: 

CALL MRESET (MET, ST) 

MDUMP 

Transfers ECS dump information to file OUTPUT 
for printing. Transferred information includes 
contents of MAP status registers, register files, 
and macro memory as well as information specified 
by MDUMP call arguments. (Refer also to MDUMP 
Control Card in section 4. ) 
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Sequence: Example: 

CALL MDUMP (x, y, z, c) CALL MDUMP (X, Y, Z, 0) 

x,y, z, c 0: Do not include following 

MAP information in dump. 

MDRLSE 
nonzero: Include following 
MAP information in dump. Releases MAP ECS dump area without printing it and 

clears dump area interlock word, 
x; data storage section x 
contents. Sequence /Example: 

y; data storage section y CALL MDRLSE 

contents. 

z; data storage section z 
contents. 

c; control and subcontrol 
memory contents. 
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MACROS 



This section describes standard and optional macros 
that may be placed in a macro string by means of 
the MACRO call described in section 2. A macro 
may be placed in a macro string only if the micro- 
code for the macro is part of the controlware speci- 
fied by the MET OPEN call that establishes the MET 
for the macro string. 

Macros are referenced in this section by their 
mnemonics. Appendix B contains a summary that 
provides the full name for each macro. 



MACRO CATEGORIES 

Macros are mnemonics that represent and call into 
execution MAP microcode sequences. Macros are 
divided into the following categories. 

• Control/pseudo macros determine control- 
flow within a macro string. 

• ECS input/output macros transfer data 
between ECS and MAP data storage. 

• Arithmetic macros perform various array 
calculations, many of which involve two 
operand arrays and a result array. 
Generally, MAP operates most efficiently 
when each of the three arrays resides in a 
separate section of data storage. Refer to 
individual macro descriptions for more 
specific information. 



MACRO PARAMETERS 

Appendix A contains tables that define parameters 
required for those macros that use parameters. 



RJUMP 

Allows control to transfer from original macro 
sequence to secondary sequence, then back to original 
sequence. Secondary sequence entry location is 
specified by paraddr argument of MACRO call. 

RJUMP adds 1 to current macro memory program 
address, places result in JUMP macro, stores JUMP 
macro at address paraddr, and transfers control to 
address paraddr+1. Sequence starting at address 
paraddr+1 returns control to original sequence by 
jumping to address paraddr. 



HALT 

Stops macro execution. All macro strings should 
terminate with HALT. 



END 

Causes jump to HALT macro (labeled- INIS) auto- 
matically stored by MSAM at first location of macro 
field (location 6). User can terminate macro string 
without END by inserting HALT macro(s) where 
appropriate. 



UPM 

Replaces or adds value to common parameter (s) 
defined by MPARAM call. This allows parameters 
to be modified during macro string execution. 
Table A-2 defines UPM parameters. 



CONTROL/PSEUDO MACROS 

NOOP 

Transfers control to next macro. 



TMM 

Compares value to common parameter defined by 
MPARAM call. Transfers control to next location 
when values are not equal. Transfers control to 
next location plus one when values are equal. 
Table A-2 defines TMM parameters. 



JUMP 

Transfers control to macro memory location speci- 
fied by paraddr argument of MACRO call. 



XMM2DM/XDM2MM 

Allows integer values between 131 071 and -131 072 
to be exchanged between MAP macro memory and 
data storage as follows: 

FLAG 
Parameter 



Macro 
XMM2DM 



Transfer 

Macro memory- to- 
data storage. 



XDM2MM Data storage-to- 
macro memory. 
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Macro memory- to- data storage transfer can be part 
of sequence for transferring macro memory data to 
ECS. 

Table A- 12 defines parameters for these macros. 
Each macro automatically selects FLAG parameter. 
AU parameter points to first macro memory location 
to supply or receive data (use MPARAM call to link 
AU parameter to first transfer location). D FWA, 
D OFF, and D IF parameter values must each be 0. 



ECS INPUT/OUTPUT MACROS 



LOADP32 

Transfers data from ECS to MAP using format shown 
in figure 3-1. Table A-3 defines LOADF32 
parameters. 



59 



28 27 



32-Bit Word 



Unused 



Table A-3 defines LOADL32 parameters. 



NOTE 



The following UNLDL32 and UNLDR32 
macros require approximately twice as 
much execution time per word as their 
LOADL32 and LOADR32 counterparts. 
When possible, use the UNLDP32 or 
UNLDP30 macro to transfer data from 
MAP to ECS. 



UNLDL32 



UNLDP32 

Transfers data from MAP to ECS using format 
shown in figure 3-1. Table A-4 defines UNLDP32 
parameters. 



Transfers data from MAP to ECS according to 
following format. 



59 



28 27 



32-Bit Word 



Sign Fi 



EZI 



LOADP30 

Transfers data from ECS to MAP according to 
following format. 



59 



30 29 



30-Bit Word 1 



30- Bit Word 2 



Table A-3 defines LOADP30 parameters. 



Table A-4 defines UNLDL32 parameters. 



LOADR32 

Transfers data from ECS to MAP according to 
following format. 



59 




32 31 





Unused 


32-Bit Word 



UNLDP30 

Transfers data from MAP to ECS according to 
following format. 



59 



30 29 



30- Bit Word 1 



30-Bit Word 2 



Table A-4 defines UNLDP30 parameters. 



Table A-3 defines LOADR32 parameters. 



UNLOR32 

Transfers data from MAP to ECS according to 
following format. 



59 


32 31 





Sign Extension 


32-Bit Word 



IOADL32 

Transfers data from ECS to MAP according to 
following format. 



Table A-4 defines TJNLDR32 parameters. 
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59 












28 


27 















l(32)t 


2(28) 


59 56 55 24 23 


2(4) 


3(32) 


4(24) 


59 52 51 20 19 


4(8) 


5(32) 


6(20) 


59 48 47 16 15 


6(12) 


7(32) 


8(16) 


59 44-43 12 11 


8(16) 


9(32) 


10(12) 


59 40 39 8 7 


10(20) 


11(32) 


12(8) 


59 36 35 4 3 


12(24) 


13(32) 


14(4) 



CM/ECS word 1 



CM /ECS word 2 



CM/ECS word 3 



EM/ECS word 4 



CM /ECS word 5 



CM/ECS word 6 



14(4) CM/ECS word 7 



59 




32 


31 







14(28) 


15(32) 



CM/ECS word 8 



taa(bb) = bb bits of 32 -bit word aa 

Figure 3-1. Packed 32 -Bit Format 



ARITHMETIC MACROS 



SUMPROD 



Performs correlation or convolution operation on 

filter array A , Aj, A LA- 1 and trace array 

Bo, Bj B LB-1' yielding result array 



c , C x 



Clc-1 defined by: 



LA-1 



C. = 2 A i B j+si+shift 
i=0 



Correlation occurs when s is 1 and convolution 
occurs when s is -1. shift is a positive, negative, 
or zero integer that specifies an initial shift of 
array A with respect to array B as shown in tables 
3-1 and 3-2. 

SUMPROD assumes that arrays A and B are zero 
outside their domains of definition, so pad zeros do 
not have to be included. 

MAP executes SUMPROD most efficiently when each 
array resides in a separate section of data storage. 

Table A- 5 defines SUMPROD parameters. 



LA, LB. and LC are positive integers and 
LB > LA > 10. 
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TABLE 3-1. SUMPROD WITH POSITIVE shift 



s, shift, j 



Array Relationship For Products 



♦i.D.O ° ° ° ° B B l B E B 3 8 M B S 

D ° D A D A l A 5 A 3 \ A s 

i n - ° ° ° ° B n B l B 3 8 ^ B u B c 

+1,0.1 1 5 3 M 5 

D D D D Aq Ai a 2 A3 ^ 

■U-D ° ° ° ° B ° 8 1 B = B 3 B M B 5 

A 4 A 3 Ag A 1 A Q D D 



-1.0.3, ° ° ° ° B B l B 2 B 3 8 M B s 
A s A M A 3 A 5 A 1 A D D D 



-, 3 „ ° ° ° ° B Q B l B 3 B, B u B c 

+1,5.0 1 5 3 4 S 

a o o a q Al a s a 3 

+1,5,1 ° ° ° D B B l B 5 *3 B 4 B S 

D A Q A 1 A 2 

-1.3.0 ° ° ° ° B B l B 5 B 3 S M B S 

A b A s \ A 3 A a A i A o a ° ° 



-wa ° ° ° OB o B i B 5 B 3 B 4 B S 

A ? A b A 5 A H A 3 Ag A x A Q 



Qj 



A o B o +A i B i +A aV- 



A o B i +A i B s +A a B 3 + - 



A o 8 o 



A B 1 +A 1 B 



A nB 3 *A.B,+A a B 



o B a* A i b 3 +A aV"- 



A o B 3 +A iV A aV" 



A o B a +A i B r A a B o 



A o B 3 +A 1 B a +A a B 1 * A 3 8 o 



LA-l 



C j 



** A i B j+si+shift 



i=0 
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TABLE 3-2. SUMPROD WITH NEGATIVE shift 



s, shift, j 



+1.-2,0 



+1,~2,1 



+1.-2,3 



-1,-2.0 



-1,-2,1 



•1,-2,2 



Array Relationship For Products 



B B], B 2 83 B 4 B S 
Ag A l Ag A3 A M A S A b A 7 

B D B l S a B 3 B H B 5 
A D A], Ag A 3 A H A S A b 

B Bj, B a B 3 B4 B S 
A A], Ag A 3 A M A s 

Bq Bi B 2 B 3 B14 B S 
Ag Ai Aq 

Bo Bi Ba 83 Bn B5 
A 3 A 2 A l A D 

□ B Bi Bg B3 B 4 Bs 
Am A3 Ag Ai Aq D 



LA-1 



1 - * A iV 



j + si+shift 



i=0 



C] 



AgBo+A3Bl+AHB2+. 



A lBo +A 2Bi+A 3 B E ^ 



A B +A lBl+AgBg+ 



AQfio 



STKMOVE 

Performs stack operation (array sum) or move 
operation (array relocation) on arrays A Q , A-,, .... 
A LC-1 and B 0' B 1> • • -, B LC-1, yielding result 
array Cq, Cj, . . . , Clc-1 defined by: 

C^A^B. (stack) 

C^A. (move) 

LC is a positive integer. 

User need not supply zero-filled B array for move 
operation. MAP executes STKMOVE most efficiently 
when each array resides in a separate section of 
data storage. 



NOTE 



Some moves that overlap old and new list 
locations require negative increment 
factors. For example, to transfer a list 
from locations 300 through 399 to locations 
350 through 449, set array first word 
addresses to 399 and 449, and set the 
increment factor for each array to -1. 

Table A-6 defines STKMOVE parameters. 
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CPLXFFT 



Performs fast Fourier transformation (FFT) on 

complex series B Q) B x , B N ,, yielding complex 

series Cq.Cj, . . . , U C N _ x defined fey: 



N-l 

C, = S B.W 
K 3 



-jk 



J 



= 



N is 2 and n is an integer not less than 3. 

i isV^lT 

W is exp (2 w i/N). 

k is 0,1,.. . ,N-1. 

Real parts of Bj, imaginary parts of B.;, and sine/ 
cosine table must each reside in separate sections 
of MAP data storage. After CLPXFFT executes, 
real and imaginary parts of each C k occupy locations 
initially occupied by real and imaginary parts of B k . 

Table A-7 defines CPLXFFT parameters. 



N is 2 and n is an integer not less than 4. 

M (figure 3-2) is N/2. 

i is,/-l. 

W is exp (2 i, i/N). 

k is 0, 1, . . ...N-l. 

Figure 3-2 shows MAP data storage placement of 
real series before execution and first M+l points of 
complex series after execution. Sine/cosine table 
resides in remaining section of data storage. 
Following relationship may be used to obtain re- 
maining points of complex series. 



C k =C N-k 



M<k<N. 

——Denotes' complex conjugate (if C is x+iy 
C is x-iy). 

Table A-8 defines REALFFT parameters. 



ICPXFFT 

Inverses process performed by CPLXFFT. 
ICPXFFT performs FFT on complex series C n , C,, 
... , Cjj, i, yielding complex series Bn, Bi , . . . , X ' 
B N _! defined by: 1 

N-l 

B, = (1/N) 2 C.W^ k 
3 k 

k= 

N,W, k are as defined for CPLXFFT and 
j is 0,1, N-l. 

Real parts of C k , imaginary parts of C k , and sine/ 
cosine table must each reside in separate sections 
of MAP data storage. After ICPXFFT executes, 
real and imaginary parts of each Bj occupy locations 
initially occupied by real and imaginary parts of C . 

Table A-7 defines ICPXFFT parameters. 



INVRFFT 

Inverses process performed by REALFFT. 
INVRFFT performs FFT on complex series C n ,C 
. . . , Cn - 1 , yielding real series R , R ..... R ° 1 ' 
defined by: N-l 

N-l 

R k =(l/N) 2 CjW3 k 

j=0 

N,W, k are as defined for REALFFT. 

C Q and C M must be real and user should supply onlv 

MAP data storage placement of first M+l points of 
complex series before execution and all N points of 
real series after execution. Sine /cosine table re- 
sides in remaining section of data storage. 

Table A- 9 defines INVRFFT parameters. 



REALFFT 

Performs FFT on real series R Q , R 1; . . . , R N ,. 

yielding data to form complex series C n , C, 

C N _ j defined by: ° !'•••• 



N-l 



C k = 



2 R.W 
J 



-jk 



3=0 



3-6 



60428900 D 



MAP Data Storage 
Relative Address 

Both Sections 



1 

2 



M-l 

M 



Before REALFFT 
After INVRFFT 



After REALFFT 
Before INVRFFT 



Section 1 



Section 2 



Section 1 



R„ 



R.-, 



R„ 



R 



N-2 



no 

data 



R l 


R 3 


R 5 




R N-1 


no 

data 



RE(C Q ) 



REfCj) 



RE(C 2 ) 



Section 2 



RE(C M-1> 



RE(C M ) 



IM(C ) = 



IM(Cj) 



IM(C 2 ) 



IM(C M-1» 



IM(C M ) = 



NOTES: 



= i real point 



RE(C.) 



real part of i 4 " complex point 

th 



IM(Ci> = imaginary part of i th complex point 



Figure 3-2. REALFFT /INVRFFT Data Storage Use 



FILTER 

Uses Weiner-Levinson algorithm to solve Weiner- 
Hopf equation 



r r l r 2 r 3 

r l r r l r 2 

r 2 r l r r l 

r 3 r 2 r i r 



r 
n 


Po" 




Pol 


Vi 


F l 




G i 


r n-2 








r n-3 








r o_ 


F 

-a 




G 

_ n_ 



for array Fj where arrays r[ and Gj are given. To 
solve Weiner-Hopf equation, FILTER first solves 
auxiliary equation 



n 


V 




a 
n 


n-1 


a l 







n-2 








n-3 


, 




' 


_ 


a 
_n_ 








r r l r 2 r 3 

r l r r l r 2 

r 2 r l r r i 

r 3 r 2 r i r 



for array a t where array a.^ is prediction error 
operator for unit prediction distance with ag=l, and 
an is expected error for n+1 element operator. 
FILTER then uses array aj from second equation 
to solve first equation for array Fj. 

FILTER parameters accommodate following pro- 
cessing options. 

• When IFSPIKE parameter is zero, FILTER 
stops when second equation is solved. 
User program may then examine array aj 
to determine whether FILTER should solve 
first equation. 



When IFSPIKE parameter is nonzero, 
FILTER solves both equations. 

• When IFSTABL parameter is zero, FILTER 
checks array a^ during generation to deter- 
mine whether array Fi is stable. If array 
F { is unstable, FILTER returns code and 
length of stable portion of array F. in 
parameter-specified locations. Arrays Fj 
and A^ contain only elements corresponding 
to stable portion of array F^. 

When IFSTABL parameter is nonzero, 
FILTER does not check stability. 

• Length MS and length MD can be used to 
save FILTER execution time after trial 
execution. For example, assume user has 
2 00- element F^ array to calculate but elects 
to calculate first 20 elements, perform 
check, and then conditionally calculate 
remaining 180 elements. For first calcula- 
tion, user loads 2 00- element r t and G: 
arrays, sets MD parameter to 20, and sets 
MS parameter to zero. For second 
calculation, user ensures that all arrays 
and three-word ALPHA buffer are intact, 
sets MD parameter to 200, and sets MS 
parameter to 20. Upon receipt of second 
request, FILTER starts calculating at 
twenty-first element using previously 
calculated elements. 

FILTER also checks for conditions indicating that 
array Fj is singular. When it detects singular 
condition, FILTER returns code in parameter- 
specified location. 

Table A- 10 defines FILTER parameters. 
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NMO 

Accepts seismic trace and produces output trace 
corrected for normal moveout. NMO reports 
apparently muted (zero) values in input trace, allows 
for muting front portion of output trace, and oper- 
ates in alternate mode to produce output trace for 
later input to velocity analysis programs. 

NMO transfers to the output trace input trace 
samples selected by addressing equation 

Ij - vfe*V t ) + (j*T r ) 2 - Tl 



I. 



Macro 


Calculation 


FLAG 
Param 
eter 


Equivalent 
FORTRAN 
Statement 


CVEC 


Copy vector 





D(I)=A(I) 


NVEC 


Negate vector 


1 


D(I)=-A(I) 


MVEC 


Magnitude 
vector 


2 


D(I)=ABS[A(I)] 


NMVEC 


Negative 

magnitude 

vector 


3 


D(I) = -ABS[A(I)] 



T r is input trace sample rate (nominally 
milliseconds). 

Tj is time of first input trace sample (same 
unit as T r ). 

Vj is sample i (i and j may differ) of array 
containing squared inverse velocity values. 
(If D is in feet and T r is in milliseconds, 
array V is in milliseconds per foot squared. ) 

D is squared offset distance corresponding to 
surface position of input trace. 

L is unrounded j th address of input trace 
array. NMO converts Ij to integer by 
rounding up, then stores sample from I, at 
location j of output trace array. 

User can employ parameter K2 and BETA array 
value THRESH to mute (clear) beginning of output 
trace. THRESH determines index J-thresH' which 
is last output trace index where two consecutive 
arrival times differ by less than THRESH. Arrival 
time, T, is computed by: 



■& 



! V t ) + (j> 



'T r > 



NMO mutes output trace by clearing first K samples. 



K = max (K2, J 



). 



THRESH 

Table A- 11 defines NMO parameters, velocity 
function list, and BETA array. 



Table A- 12 defines parameters for these macros 
Each macro automatically selects appropriate FLAG 
parameter. AU parameter value of 1, 2 3 4 
selects corresponding MAP add/subtract' unit 



ADOVEC/SUBVEC/MULVEC/DIVVEC 

Perform following calculations. 



Macro Calculation 



FLAG 
Param- 
eter 



Equivalent 
FORTRAN 
Statement 



ADDVEC Add vectors 

SUBVEC Subtract 
vectors 

MULVEC Multiply 
vectors 

DIVVEC Divide 
vectors 



D(I) = A(I)+B(I) 
D(1)=A(I)-B(I) 

D(I) = A(I)*B(I) 

D(I) = A(I)/B(I) 



Table A- 13 defines parameters for these macros. 
Each macro automatically selects appropriate FLAG 
parameter. AU parameter value of 1, 2 selects 
corresponding MAP add/subtract/multiply/divide 
unit. AU parameter value of 3, 4 selects correspond- 
ing add/subtract/multiply unit. 



CVEC/NVEC/MVEC/NMVEC 

Perform following calculations. 



IPVEC 

Performs inner product vector calculation defined by: 
D(final)=0(initial)+ Z A(I)*B(I). 
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Table A-13 defines IPVEC parameters. D IF param- 
eter must be set to to produce scalar D(final). 
FLAG parameter value of clears D(initial). FLAG 
parameter value of 1 leaves D(initial) undisturbed. 
AU parameter value of 1, 2, 3,4 selects corresponding 
MAP add/subtract and multiply units. 



SUMRVEC 

Perforins sum reduction vector calculation defined 
by: 

D(final)=D(initial)+ 2 A (I). 

Table A-12 defines SUMRVEC parameters. D IF 
parameter must be set to to produce scalar 
D(final). FLAG parameter value of clears 
D(initial). FLAG parameter value of 1 leaves 
DUnitial) undisturbed. AU parameter value of 
1,2,3,4 selects corresponding MAP add/subtract 
unit. 



ZEROVEC/BCASVEC 

Perform following calculations. 



Macro 



FLAG 
Param- 
Calculation eter 



ZEROVEC Zero array 

BCASVEC Broadcast 
scalar 



Equivalent 
FORTRAN 
Statement 

D(I)=0 

D(I)=A 



Table A-12 defines parameters for these macros. 
Each macro automatically selects appropriate FLAG 
parameter. A IF parameter value must be for 
BCASVEC. ZEROVEC ignores A FWA, A OFF, and 
A IF parameters. AU parameter value of 1, 2, 3,4 
selects corresponding MAP add/subtract unit. 



MINE/MAXE 

Perform following calculations. 



Table A-13 defines parameters for these macros. 
Each macro automatically selects appropriate FLAG 
parameter. AU parameter value must be for each 
macro. 



SQRTVEC 

Performs square root vector calculation equivalent 
to FORTRAN statement D(I)=SQRT(A(I». 

MAP provides positive root and declares square root 
error for each negative element of A(I). 

Table A-12 defines SQRTVEC parameters. FLAG 
parameter value must be 0. AU parameter value of 
1, 2 selects corresponding MAP square root unit. 



MAVVS/MAVSV/MAVVV 

Perform following calculations. 



Macro 



Calculation 



MAWS Multiply add 
vector, vec- 
tor, scalar 

MAVSV Multiply add 
vector, sca- 
lar, vector 

MAVVV Multiply add 
vector, vec - 
tor, vector 



FLAG Equivalent 

Param- FORTRAN 

eter Statement 

D(I) = (Att)*B(I))+C 



D(I) = (A(I)*C)+B(I) 



D(I) = (A(I)*B(D) 
+C(I) 



For MAWS/ MAVSV and MAVVV, arrays A, B, D 
and A, B, C, respectively, should reside in separate 
sections of MAP data storage. 

Table A- 14 defines parameters for these macros. 
Each macro automatically selects appropriate FLAG 
parameter. For MAWS and MAVSV, C IF param- 
eter value must be 0. AU parameter value of 1, 2, 3,4 
selects corresponding MAP add /subtract and 
multiply units. 



FLAG Equivalent 

Param- FORTRAN 

Macro Calculation eter Statement 



MINE MIN elements 
MAXE MAX elements 



D(I)AMIN1[A(I), 
B(I)1 

D(I)=AMAX1[A(I), 
BO)] 



TVEC 

MAP automatically rounds up when converting data 
storage values to external fixed- point values. TVEC 
counters this roundup by preprocessing values 
according to following equivalent FORTRAN state- 
ments. 

If A(I) . GE. 1. 0, then D(I)=A(I)-. 5 

If A(I) . LE. -1. 0, then D(I) = A(I)+. 5 

IfA(I).LT. 1.0 and A(I) . GT. -1.0, then D(I)=0. 
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Table A-12 defines TVEC parameters. FLAG pa- 
rameter value must be 0. AU parameter must 
point to macro memory location containing 200 a 
(use MPARAM call to link AU parameter to loca- 
tion containing 200„). 



COMVEC 

Tests corresponding elements in two arrays, re- 
cords number of test failures, and records offsets 
for first elements that fail test. Table A-12 defines 
COMVEC parameters. FLAG parameter value 
selects test as follows : 



FLAG Parameter 


Equivalent FORTRAN 
Test Statement 





A(I) . EQ. D(I) 


1 


A(I) . LE. DU) 


2 


A(I) . LT. D(I) 



AU parameter points to first of three macro mem- 
ory locations to hold test results (use MPARAM call 
to link AU parameter to first test result location). 
Test result locations are defined as follows: 

Location Contents 

First Number of times test failed. 

Second Absolute offset from A of first A 

element to fail test. 



Third 



Absolute offset from D of first D 
element to fail test. 
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PROGRAMMING 



This section contains miscellaneous programming 
information related to the MAP III system and pro- 
vides example programs. 



all of the dump information from ECS to an output 
file with an MDUMP control card (abort situation) 
or an MDUMP call (unconditional dump). 



FILE DECLARATION 

A user program making MSAM calls should declare 
file OUTPUT on the PROGRAM card. 



FIELD LENGTH ALLOCATION 

Because MSAM consists of object-time routines, 
the user should allocate an additional 3100g words 
of central memory to accommodate these routines. 

Also, the user program must dimension buffer 
areas for MSSI elements that reside in the user 
field length. The following list provides approxi- 
mate sizes for these elements. To determine the 
exact buffer length for a particular macro string, 
refer to the symbolic reference table and memory 
map generated by the ref argument of the 
MAPNOGO call. 



MSSI Element 
MET 
Symbol table 



Macro string 
buffer 



Timing table 
(optional) 

Error table 
(optional) 



60-Bit Word 
Requirement 

8 per MET. 

4 plus 2 for each MALLOT 
and MEQUIV call. 

8 plus 14 for each MACRO 
call plus 2 for each MPARAM 
call plus an additional 3 for 
each macro requiring type 3 
parameters (table A -14). 

64. 



64. 



MDUMP CONTROL CARD 

This control card transfers part or all of the ECS 
dump area to an output file and then prints the file. 

MSSI transfers the contents of MAP status regis- 
ters, register files, macro memory, control mem- 
ory, subcontrol memory, and data storage to the 
ECS dump area when requested by the febits argu- 
ment of a MAPGO call or when a fatal MAP execu- 
tion error occurs. The user can then copy part or 



Once it has loaded the ECS dump area, MSSI pre- 
vents writing into the dump area until one of the 
following occurs. 

• The user job issues an MDUMP call or 
executes an MDUMP control card. 

• The user program issues an MDRLSE call. 

• The operator issues a MAP, NODUMP. 
command. 

When a user program is likely to result in a MAP 
dump, the user should ensure that the ECS dump 
area is released after the dump either by including 
an MDUMP or MDRLSE call in the program or by 
including an MDUMP control card in the control 
card deck. 

The MDUMP control card format is: 

MDUMP[(X, Y. Z, C>] 

All arguments are optional. 

X, Y. Z Print indicated section of MAP 
data storage. 

C Print MAP control and subcontrol 

memories. 

Transferred information includes the contents of 
MAP status registers, register files, and macro 
memory as well as the information specified by 
MDUMP control card arguments. 



MET/MACRO STRINGS 

As long as the user allocates sufficient field length, 
there is no restriction on the number of METs or 
macro strings employed by a program. A MAPGO 
call may have any open METT listed as the met 
argument. MSAM status bit 17 (informative status) 
sets when the met argument of a MAPGO call is not 
the same as the met argument used when building 
the macro string. 



LOCE FUNCTION 

The LOCE function may be used to obtain the ECS 
address of an ECS-resident variable. 



f MET referenced must specify proper system library for macro string. 
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NOTE | 



Bit 59 of LOCE-returned ECS address 
is 0. 



Format: 

loc = LOCE (variable) 

loc Location to receive ECS ad- 

dress of ECS-resident variable. 

variable ECS-resident variable. 

Example: 

LOCA = LOCE (IBC) 

MAP REQUESTS 

MSSI uses an ECS-resident schedule table to handle 
MAP requests. The schedule table contains a fixed 
number of elements, called requests. A request 
can reside in one of three chains called empty, 
inactive, and active. A METOPEN call moves a 
request from the empty to the inactive chain and 
assigns the request to the MET identified in the 
call. A MAPGO call moves the request from the 
inactive to the active chain for MAP processing. 
When MAP processing completes, the request re- 
turns to the inactive chain. 

When a MET is no longer needed, the user program 
should close the MET with an MCLOSE call to move 
the associated request from the inactive to the 
empty chain. 



• An odd value less than 200o indicates that 
the last MSAM -requested action is 
complete. 

• A 2xx„ value indicates a CP monitor error 
return. 

• A 3xx 8 value indicates a MAP PP driver 
error return. 

MET code /status values are described as follows: 



MSAM REQUEST VALUES 

Octal Value 



Description 



120 


Request copy of schedule table 


122 


Read ECS dump table. 


124 


Read ECS partition table. 


130. 


Clear dump table interlock. 


140 


MET open. 


150 


MET close. 


160 


Request active entry. 


170 


Lock MAP. 


172 


Unlock MAP (on-line diaenostir 



only). 

174 Down MAP (on-line diagnostics 

only). 

176 Up MAP. 



PROGRAM RECALL 

MSSI provides two methods of suspending program 
execution while a macro string executes. The first 
method is to provide a nonzero value as the recall 
argument of the MAPGO call that requests macro 
string execution. This suspends program execution 
until the macro string completes execution. 

The second method is to provide as the recall 
argument of the MAPGO call, continue program 
execution as desired, and then issue an MRECALL 
call to suspend program execution until the macro 
string completes execution. 



MET CODE/STATUS VALUES 

MSAM communicates with the CP monitor and MAP 
PP driver by means of a 9-bit MET code/status 
value stored in bits through 8 of the first 60-bit 
word in a MET. Rules for interpreting MET code/ 
status values are: 

• An even value less than 200 8 indicates that 
MSAM has requested action, but the action 
is not yet complete. 



CP MONITOR ERROR RETURN VALUES 



Octal Value 


Description 


211 


Illegal MET. 


213 


MAP locked. 


215 


Unknown schedule table entry. 


217 


MAP down. 


221 


Requested equipment not 
available. 


231 


Open/close sequence error. 


241 


Schedule table full. 


251 


MET close while active. 


261 


Illegal function code. 


271 


Illegal dump reauest. 
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MAP PP DRIVER ERROR RETURN VALUES 



Octal Value 
3 11 

321 
323 
331 
341 

351 
361 



Description 

Macro string time limit 
exceeded. 

Fatal MAP execution error. 

Nonfatal MAP execution error. 

Control point error. 

User CM or ECS address out 
of range. 

Macro string checkword error. 

MP3 -detected hardware error. 



For example, if TIME is the timing table first word 
address, the entry for the ICPXFFT (05 8 ) macro is 
at TIME+5. If TITAB is the FORTRAN array name 
for the timing table array, the entry for the 
ICPXFFT (05„) macro is TITAB(6). 



The timing table entry format is: 



£9_ 



_££. 



Number of times 
this macro has 
executed 



M_ 







Total number of milli- 
seconds (NOS) or quarter- 
milliseconds (NOS/BE) 
spent executing this 
macro 



The error table entry format is: 
59 48 47 



Unused 



MAP status as described in 
table 2-1 



TIMING/ERROR TABLES 

The MAPGO call allows a user program to define 
two 64 -word tables where MSSI records cumulative 
timing and error information for each type of 
macro. When cumulative results are not desired, 
the user should initialize each table before issuing 
the MAPGO call defining the tables. Either or both 
of the tables may be deleted by using 7LNOTABLE 
as the timtable/errtable argument of the MAPGO 
call. 

Table entries are arranged according to the macro 
codes listed in table B-l. To obtain the address 
corresponding to the entry for a macro type, add 
the macro code to the first address of the table. 



EXAMPLE PROGRAMS 

The following programs show how MSAM calls are 
used to generate and execute macro strings. 



PROGRAM SOP 

This program reads two arrays from separate 
tapes, performs a sum-of-products calculation on 
the arrays, and then returns the result to a third 
tape. Figure 4-1 shows data flow for program 
SOP. 



CM 



ECS 



MAP 



(TAPE D- 



(TAPE 2)- 
(TAPE 3)x 



DATA 1 




Pl(8) 






X ■ 


SAMPLE 1 




P2(8) 


Y ■ 


— > 




DATA 2 




SAMPLE 2 








Z • 






P2(9) 










RESULT 

















Figure 4-1. SOP Data Flow 
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PROGRAM. SJP (OUTPUT. TAPE1.T4PE2,TAP= 3) 
C 

C THIS PROGRAM REAOS 130 SAMPLES EACH FROM TAPE1 ANO TAPE2. T4*Y ARE 

- »2I5' D t2- INTO MAP DATA ^"D** ^5'S A SUH Of PRODUCTS 13 PERFORMED 

j. AND THc fitSJLT IS WRITTEN TO ECS. < E3JLTS AR6 THEN WRITTEN TO 

C TAPt3 PRIOR TO PROCESSING THE St<T i ET OF SAMPLES. 



RESERVE BUFFER SPACE FOP TASLFS ANO APRAYS 



DIMENSION M=T{38>, M4CC80), ISY'KIO), ITIM(6<.). IERR(d*) 
DlrttNSION 0ATAH100), DATA2(100), PI (IX), P2(ll), P3tll), P4CJI 

INTEGER PI, P?, P3, ?<, 
TST » 

C 

C OtFINE »ARA1ETERS FOR LOAD L EF T-JUST IFI6D 32 8IT DATA 

v. 

fllll ■ 7LSAMPLE1 

P2(l) * 7LSAMPLE2 

'1(21 » P2(2) « 1 

Pl(3) ■ P?(3> » 100 

Pl(4) • P2(<>) « 16C43 

PK5J • P?t5> ■ 603 

Pl(6) » P2{6) . 1777776 

PK7J « F2(7) » 

fl(8) » 

Pl(9) - Pl(8) + 100 

>>2(3> « PIO) +1 

P2(9) » P2(3) ♦ 100 
PK10) » P2(10) * 1 
Pl(ll) » ?2(11) • 
w 

C StT UP PARAMETERS F 3R SUM DF PRODUCT < 

C 

P3(l) - 7L3A*PLE1 

P3(2) - F3C) « P3(6) » 1 

P3(3) « 7LS4.1PIE? 

?3(5) * 6LRF3JLT 

P3(7> » P3C3) - P3(9> ■ 100 

P3C10J * I 

P3(ll) « 3 
C 

C SET UP PARAMETERS FOR UMJIO LSFT-Jj STIFIEO 32 BIT DATA 

P4(l> ■ 6LRESULT 

PM2) » 1 

B M3) » 100 

ft(<») » 1<.0«3 

PM5) ■ 77238 

PM6I » 1777778 v 

RM7) » 

P4<8) * P2(3| 

PM9) « (P2(8» ♦ 101J/3 *3 * 8 

C ScT UP .itT AND DEFINE ARRAYS 

C 

CALL METOPE (1FT, ISYM, 3, 0, 1ST) 
CALL 1ALLUT (1ST, 7LSAMPLS1. 130, 2l NS, 1LX. 1ST) 
CALL 1ALL3T (1ST, 7L3AMPLE2. 100, 2l KS. 1LY, 1ST) 
CALL M4LLJT (MET, 5LR<-SULT. 100. 2L*S. HZ, 1ST) 

C CReAT€ 1ACRC STRING ArtJ u3TAIN S/M331IC RtFe*rNCE T4HLS. 

v IF tRRORS IH STATUS, CUL USt R-QE F U 10 ERROR MANGLING ROUTINE. 

CAlL MAPSET (MET, MAC. 80. 1ST) 

CALL MACRO <M4C> 0, 7LL0ADL32, t-1, I ST I 

CALL MACRO MAC, 0, 7LL0A0L32, P?, 1ST) 

CALL MACRO (MAC, 0, 7LSL'MPB0e, 33, 1ST) 

CALL MACRO (MAC, 0, 7LUNLD132, P'. . 1ST) 

CAuL 1APNJG0 (MET. 1AC, 1ST. 1) 

IF (1ST .NS. 0) CALL FRRCRS (1ST) 

Z READ IMPUT, XFES TO ?C3, ANO SXECUTi SOP 
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v. 



10 RfcAO (1,100) (DATAHI), I « 1,103) 
IF (cOHl)) 33, 5 
5 CONTINUE 

WRITE 13,200) 

WRITS ' (3,300) (DATAKI), I » 1,100) 

READ (2,100) (DATA2(I), I » 1,100) 

WRITE (3,300) 

WRITE (3,300) (DATAZm, t » 1.100) 

CALL WRITcC (0ATA1, »1(8), 100) 

CALL WRITcC (0ATA2, P2<8>, 100) 

CALL MAP6J (MET. ftAC, ITI-1 , IERR, 1, 9, 1ST) 

CAcL RSAOEC OATA2, B *(6)> 100) 

WRITE (3,*00> 

rfRITE (3,300) (OATAZ(I), I « 1,1111 

GO TO 10 
9? STJP 

100 FQR1AT (5(F10.5)) 

200 FORMAT (lrll,*X,llHDATAl INPUT /) 

300 P3R1AT (// 5X,11H0ATA2 IN°UT /) 

*0J F0R1AT (1H1,*X,7HR!:SULTS /) 

500 FdRIAT (5I2K.F1C.5) ) 

END 



SUBROUTINE ERRORS (1ST) 

PRINT cRRJR IfcSSAGF IF ERROR STATUS RECEWfcO 

PRINT 100, 1ST 
10j FG««Ar(/// 1CX.37H*** «AF STATUS ER*CR *** STATUS IS #120 ///) 
RETURN 
ENO 



1ACR0 STRIM5 REFERENCE TABLc 

l*(D) UNUSED .1ACR3 STRING 6JFFEK wOROS 

instruction dL?c< smsois 



LA9FL L1C RsFc< UNCI'S 
FINIS 0006 000017 



PARAMETER UOC< Sri33LS 



LA3EL L3C VALUc Rtrc«s*ICES 

SAMPLE? 00*2 000000 000060 000071 

5A.MPLE1 00*3 000000 000056 00010* 

RESULT 00*4 000000 0000*3 000062 



DATA 1S"1QRV .1A? 

X FL (SAVE) « 000000 X fL (TOTAL) » 0001** 

1 FL (SAVE) • 000000 Y Fl ( TOTAL) * 3J01** 

Z FL (SAVE) » OOOOJJ Z Fl (TOTAL) ■ 0001** 



APRAT TTPE Mil rtAP RA 

SAHPLE1 MS » 000000 

SAHPLE2 SS t 000000 

RESULT NS Z 000000 

ST^CIL TA3LE LSN3T4 10(0) WlROS 
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DATA! INPUT 








2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.0C00O 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.0000,; 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.0C000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


2.00000 


0ATA2 INPUT 








.50000 


.50000 


.50000 


•5C000 


.50000 


.50000 


.50000 


.53000 


.50000 


.5000 


.50000 


.50000 


.5 0000 


.50000 


.50000 


.50000 


•5O000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50200 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.5000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.5000. 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


. 50000 


.5000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.50000 


.5 003 


.50000 


.50000 


.50000 


.50000 


.50000 


RESULTS 










100.00000 


93.00000 


98.00000 


97.00000 


96.00000 


95.00000 


94.00000 


93.00000 


92.0C00C 


Sl.COOJC 


90.00000 


49.00000 


33.00000 


87.00000 


P6. 00000 


85.00000 


3*. 00000 


83.00000 


32.00000 


81.00000 


SO. 00000 


79.00000 


73.00000 


77.000)0 


76.00000 


75.00000 


74.00000 


73.00000 


72.00000 


71.00000 


70.00000 


69.00000 


6fl. 00000 


67.00000 


66.00000 


65.00000 


64.00000 


63.00000 


62.00000 


61.00000 


60.0000C 


59.00000 


53.00000 


57.00000 


56.00000 


55.00000 


54.00000 


53.00000 


52.00000 


51.00000 


50.00000 


49.00000 


48.00000 


47.00000 


46.00030 


* 5. 00000 


4*. 00000 


43.000C0 


42.00000 


41.0000 


40.00000 


39.00000 


38.00000 


37.00O0O 


36.00000 


35.0COOO 


34.00000 


33.00000 


32.00000 


31.00000 


30.00000 


29.00000 


28.00000 


27.00000 


26.0000 


25.00000 


24.00000 


23.00000 


22.00000 


21.00000 


20.00000 


19.00000 


i a. ooooo 


17.00000 


lo.OOOOO 


15.00000 


14.00000 


13.000CO 


12.00000 


11.00000 


10.00000 


9.00000 


a.oooo 


7.00000 


6.00030 


5.00000 


4.00000 


3.00000 


2.00000 


1.00000 
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PROGRAM NUMBERS features are used first to loop within the macro 

string to repeat a stack move macro 10 times. 
This program demonstrates the use of common pa- Then UPM is used to redefine the beginning and 

rameters established by the use of the MP ARAM ending ECS addresses for a load left-justified, 

call and testing and updating macro memory loca- 32 -bit data transfer from ECS. UPM'and TMM are 

tions with the TMM and UPM macros. These then used to repeat a second stack move macro 10 

times. 

OROGftflf NUMBERS (CUTPUT, T A = E 2=CU TPL T) 

INTEGER M£T<8), MAC(153>, SYM<1=>, 14(100), 18(103), IC(lOu) 

INTEGER PA<11), PB<11>, PC(ll), PC(^), PEC*) ,PF<<*> , 3 GC*) 

INTEGER PHfJ»>, PI<9>, TIMoil, ERfcfSO 

INTEGFP STAT 

common iflCdK) , iec(iao), iccaco 

LEVEL 3, IAC, I3C, IGC 

STAT = C 
C 

LOCA = L0CE(I6C) 

LCC3 = (LCCA + 9S + 603) /8 ♦« +fi 

LCCC = LCCE(IAC) 

wOCO = CLCCC ♦ 99) /8 *8 *8 

LOCG = LOCE(ICC) 

LOCH = (LCCG ♦ 111 ♦ 60a> /8 *S +6 
C 

OATA PA /6LeUFFE-i,l, 13:, 2373, 37E, 177777a, 3*0. 1,0/ 

OATA PT / 5LINFUT,1.1C:, 2373, 37E, 1777773, ,5LS T AST , 5LL IKIT , 1,0/ 

DATA PC /cLeUFFc^.l.iLINPUT.t.fcLaUFPEP, 1,2*0, ICO, 1,0/ 
DATA 3Q /1,*LTE'ST.2*1/ 

DATA P? /l,t.tT£ST,ia,:/ 

DATA PF /1,3LSTART,2*!:/ 

OATA PG /1,SLLIMIT,2*3/ 

OATA PH /l,-»LT£ST,2e,Q/ 

OATA PI /6L5UFFE*,l.lG-:,2»375, 1777778, 3' 0/ 
C 

OATA IA /103»3/ 

DATA 1.3 /l13»2uaJCC 53033/ 

sata ic /i;:»s:3::;q;c:?/ 
c 

PA(8) = LCCC 
PA(9) = LCC3 

pf(3) = lcc; 

°Gl3> - LCCH 
»!(SI = LCCG 

pic<u = lcch 
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CALL MCVLEV (IA,IAC,103) 
CALL KOVLEV (IB.IBCIOO) 
CALL MCVLEV (IC. ICC, 102) 

c 

CALL METOPEN (MET, SY* , 0, 0, STAT) 

CALL MAPSET (MET, MAC, 150, STAT) 

CALL MALLOT (MET, 6L3UFFER, ICC, 2LNS, 1LV, STAT) 

CALL KALLCT (h-ET, 5LINFUT, 100, 2LNS, 1LX, STAT) 

CALL HPARAf (t-AC, f»LT£ST, , 1, STAT) 

CALL ^PARAK (KAC. 5L3TART, LCCA, 1, STAT) 

CALL KFARAM (MC, 5LLIMIT, LCCe, 1, STAT) 

CALL MACRO (MAC, C, 7LLOACL32, FA, STAT) 

CALL H4CRC (MAC, 3, 7LL0ACL32, PB, STAT) 

CALL PACRC (XAC, *LLCCF, 7LSTKMCVE, FC, STAT) 

CALL MACSC (MAC, 3, 3LUPK, PC, STAT) 

CALL MACRO (MAC, C, 3LTMM, PE , STAT) 

CALL PACRC (MAC, 3, •♦LJUKP, <»LLCOP, STAT) 

CALL fACRC (KAC, 3, 3LLPh., PF , STAT) 

CALL MACRO (MAC, J, 3LU&M, PG, STAT) 

CALL MACRO (MAC, 3, 7LLOACL32, F8, STAT) 

CALL MACRO (MAC, 5LLC0P2, 7LSTK»»CV£, °C, STAT) 

CALL MACRO (MAC, 0. 3LUPN, PD, STAT) 

CALL MACRO (MAC, P., 3LTMH, PH, STAT) 

CALL MACRC (MAC, 0, <»LJUhP, 3LLCOF2, STAT) 

CALL MACPC (MAC, C, 7LUNLCL32, FI, ST«T> 

CALL MACRO (MAC, 3, 3LENC, 3, STAT) 

CALL MAPNCGO (h;Ti MAC, STAT, 1) 

CALL MAPGC (MET, MAC, TIC £58, 1, 5C0, STAT, ;l 

CALL MCVLEV (ICC, IC, lQt) 
00 1? K = i,ic:,5 

IF (IC(K).NE. 7i00C33aCG0a) GC TO 99 

IK = *♦!» 
li PRINT 20, (IC(I),I-K.IK) 
2. FCSMAT (5022) 

CALL P£HARK (16M TEST SUCCESSFUL) 

STCP 
99 PALSE *TEST FATLCD* 
ENO 
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MACRO STRING REFERENCE TABLE 

26(D) UNUSED HACRQ STRING BUFFER WCRCS 
INSTRUCTION BLOCK SYMBOLS 



LA8EL 


LOG 


REFERENCES 


FINIS 


00Q6 


3 200 43 


LOOP 


0313 


C000Z2 


LCOP2 


0031 


CC0040 



PARAMETER BLOCK SYMBOLS 



LABEL 


LOC 


VALUE 


REFERS 


NCE3 








INPUT 


£376 


030000 


0CG1Z1 


QCG132 


UQ0163 


000174 




BUFFER 


0077 


SJOOOfl 


303103 


000117 


003123 


003161 


003165 


u«r 


3 222 


3:3 370 


300142 


003145 


000234 






START 


:223 


c:;i..4 


133141 


00015C 


003203 






TEST 


0224 


« - C £ C j 


300111 


0031111 


Q0C153 


033156 





003207 



DATA PEmOSY PAP 

X FL <SAVE> = IwOfi.C X FL (TCTAU = OOCl-,4 

Y FL <SAVE> = 3C053J * FL (TCTALI = CC0144 

Z FL ISAWEI = I3CC32C Z FL CTCTAO * 003363 



APPAY TYPE f="- MAP RA 

BUFFEP NS Y 303C33 

INFUT NS X 303030 

SYH80L TAOLE LENGTH MSJ WORDS 
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PROGRAM FOURIER 

This program demonstrates use of the real fast Fourier transform macro. 



PROGRAf FOURIERCOUTPUT=513, TAPE5) 
ORIGINAL CALCULATION ARRAYS 

COMMON TRAC(1C25», SINC<102<*), RESUH1C26), R£SUKtlOZ6) 
INTEGER RCH 
LOGICAL COMP 
ECS ARRAYS FOR MAP OATA 
COKMCN /IECS/ INPRU325), SINTI102M 
REAL INPR 

LEVEL 3, ^FR, SINT 

COMMON /OECS/ CUTRU326), 0UTS(1C26I 
LEVEL 3, OUTR, OUTS 
MAP REQUIRED ARRAYS 

INTEGER M£T(8), SYMSUOI, MACI200) 

INTEGER LCTI11>, MVOU1), MVElil), LCSI11), RFTI6I, MVR(11>, 
X MVIIill, UNR<9» 

INTEGE? STAT, ETAB(6«f) 

OATA L0T/M.LCAn,l,-G,ie3<,E,6Q8,177777e,3,-a,-C,l,2/ 
DATA MVO/-G,2,3,3,«tLIMAG,l,C,G,-0,3,0/ 
DATA PV£/4LLCAC,2,S,3,'.LREAL,l,C,C,-e,a,G/ 
OATA LOS/ 3LSIN, 1,-0, 160 '♦6,6 38,1777778, 0,-0, -3, 1,3/ 
OATA RFT/^LREAL,»LIMAG,-C,3LSIK,3LC0S,1/ 
OATA MVR/^LREAL,l,0,a,<.LDL ! MP,2,C,C,-C,Q,0/ 
OATA MVI/'.LI«AG,l,3,a,-a,2,C,0,-a,3,C/ 
OATA UNR/1.LCUMF, 1,-0,1%C^B, 772 CC 1-77779,3,-3,-3/ 
PROGRAM ASSOCIATED PARAMETERS 
OATA LEV/10/ 
OATA PI/3.1<,15<32a5/ 
STATEMENT FUNCTION 
LCC8<IA»=LCCEUA) / 8 » 8 ♦ 8 
IHITIALI7E THE TRACE ARRAYS 
LIM=2 •• LEV 

PERFORM THE MAF RELATED CALLS 
CALL PETOFENCKET, SY.«e, 0, 0, STAT* 
CALL KflPSET<MET, MAC, 230, STAT) 

CALL KALLCTCHET, 4LREAL, LIM+1, 2LNS, 1LX, STAT> 
CALL KALLOT<MET, M.IMAG, LIM»1, 2L*S, 1LY, STAT) 
CALL J»ALLC7CMET, 3LSIN, LIH»2, 2LfS. 1LZ, STAT) 
CALL fALLCTCKET, *LLCAC, LIM*2, 2LNS, 1L2. STAT) 
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CAUL HALLCTCMET, <»LCUMP, LIM*2, 2LNS, 1LZ, STAT) 

CALL f ALLOT (MET, M.REL2t LIM*1, 2LNS, 1LX, STAT) 

GALL KALLCTIMET, <»LIMG2, LIM + 1, 2LNS, 1LY, STAT) 

CALL MEOUIVCMET, 3LCQS. LIK/2, 3LSIN, LIf/it, STAT) 

LDT{3) = LI)- 

LCT(8)=L0C£tINPR) 

L0T<9MLCC8(INFR<LIM>> 

CALL MACROCMACt 3, 7LLCACL32, LCT, STAT) 

MVC(l)=<tLLCAC .OR. 2 

MV0C9)=LI* / 2 

CALL MACRCMMAC. 0, 7LSTKhCVE» HVO, STAT) 

MVCC5)=J*.LIMG2 

CALL CACRC<MAC, 0, 7LSTK)<C\/E. fVC, STAT) 

MV£<9)=LI* / 2 

CALL fACROtMAC, 3, 7LSTKHCVE, I'VE, STAT) 

HVE«5)=<,LPEL2 

CALL CACRCIMAC, 0, 7LSTKhCVt, KVE, S1AT) 

LDSC3)=LIK/2 ♦ Llf/<* 

L0S«8)=LCCE(SINT) 

LDS<9l=LOC8<SINT{LI*/2 ♦ LIM/*») ) 

CALL K4CRCCMAC, 3, 7LLCAOL32, LCS, STAT) 

RFT(3)=LEW 

CALL MACRGJMAC, 

RFTCl)=vLREL2 

SFT(2) = <.LI)»G2 

CALL MACRCCMAC, 

MVR<9)=LIM/2 ♦ 1 

CALL HACRO(MAC, 0, 

cvimsfcLOtMP .om. 

MVH9>=LIf/2 ♦ 1 

CALL KACR011AC. 3, 7LSTKMCVE, KVI, STAT) 

UNS<3I=LIK *■ 2 

UKRI8)=LCCE ICLTR) 

UNR(9)=LCCStCUTRUIK ♦ 2» > 

CALL fACRCCKAC, 1. 7LLNLCL32, 

KVSIll=i»LREL2 

CALL CAC3CCKAC* 0, 7LSTKhCVE. 

KVIIX)=«»LIPG2 



7LREALFFT, RFT, STAT) 



1, 7LREALFFTt RFT, 



;tat) 



7LSTKKCVE, 
2 



fVR, STAT) 



IWP. STAT) 



)«VR. STAT) 
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CALL MACROCMAC, 3, 7LSTKMCVE, MVI, STAT) 

UNR<8>=LCCE«CLTS> 

UNR<9)=LCC8JOUTSUIM f 2)1 

CALL MACRCHMACt 0, 7LUNLCL32, UNR , STATI 

CALL *ACROINAC, 0, 3LEN0, 0, STAT) 

CALL MAPNOGOJfET, MAC, STAT, fi£F> 

GENERATE SIN / COS TAeLE 

A=2. ♦ PI / LI* 

DO 23 1=1, LI* 

SINC«I>=SIN(«I-i) » A) 
20 CCNTIMJE 

CALL WRITECCSINC, SINT, Lift) 

ROW=3 

?EAD THE TEST CATA 
30 CQKTIhUE 

ROM=RCW ♦ 1 

DO 35 1 = 1, LIM 

R=SOW 
35 TRACII>=RAhF(R) 

MOVE CATA TO ECS 

CALL HRITECITRAC. INPR, LIM) 

FIRE UP THE MAP 

CALL PAPGOCMET, MAC, 7LNCTA3LE, ETA9, 1, 53, STAT, 
1 lCG003023COOQQOGag) 

PRINT NON-2ERC ERROR TAGLE ENTRIES 

PRINT 2, ROW 

2 F09MATC»3HCN-ZER0 ERRCR TA8LE - RCW »,I2,/) 
OC t0 1*1, 6<» 

IFIETASd) .NE. 1) P°INT 3, tl-ll , ETAGCI) 

3 F0RMAT»1X,C2,2X,016> 
<-: CONTINUE 

CHECK THE DATA 

CALL RcAOECfRESUL. CUT*, LIM*2) 
CALL REAOECCRESUK, CUTS, LIH»2) 
L3T=LIM * 2 
CC«P*.TRUE. 
00 53 1=1, LST 

IF(RSSULU) .EO. RrS'JKIDI GC TC 5: 
°RINT :., I, RESUL«I), RESUKfl) 
- FORMATC* COMPARISON FAILURE - • ,1*.,? «?X ,E16.8) ) 
COMP=. FALSE. 
5C CONTINUE 

IF{.NCT.CCMP) CALL MDU*PC1, 1, 1, tl 

IFl.N.COMPJ PAUSE <TEST FAILED* 

CALL P3RLSF 

TEST IF CYCLE CCPPLETEC 

IFtRCH .LT. 2*1 GC TO 3C 

GET OUT 

CALL KCLOSEtHET. STAT» 

SNa 
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MACRO STRING REFERENCE TA3LE 

13(C) UNUSEC fcflCRO STRING BUFFER KORCS 
INSTRUCTION 8LCCK SYfteCLS 



LA3EL 
FIMS 



LOC SEFEREKCrS 

"336 Gw3C^3 



PARAMETER ELOCK SYMBOLS 



LABEL 


LOC 


VALUS 


REFERENCES 






LOAO 


1361 


032-303 


30021.6 


03 0261 






LCAO 


3062 


032002 


300223 


033233 


O0327<» 




CCS 


2063 


s:3<»a3 


30C175 


33 02 3 3 






SIM 


:j6h 


C 33053 


3Q317W 


330232 


000235 




»EAL 


I 65 


5 : 3 3 'J 


303156 


003177 


003237 




IHSG 


3366 


3;3333 


30; U3 


330203 


0C3265 




REL2 


C067 


032CC1 


300117 


300171 


00322*. 




DUMP 


•j uT G 


o:-»cc5 


3C3110 


0331<»7 






IfcG2 


ej7i 


0:23-1 


30:i3<. 


00C172 


00 252 




OU?1P 


:37z 


ai»sc<» 


333373 


333123 


000132 


003162 



OATA MEMORY PAP 

X PL CSAVE> = 3C3C.:: X FL CTCTAL) * CC*3C2 

Y FL ISAW?) = 3OCC30 Y FL (TCTAL> = 3C0L2 

7 FL (SAVE* = :OCC03 Z FL CTCTAL> = :eecte 



A RR AY 


TYPE 


M£M 


KAP Pa 


SFAL 


NS 


X 


309C3C 


If AG 


NS 


Y 


003030 


SIN 


NS 


2 


3330CC 


LOAD 


NS 


7 


332C:2 


DUMP 


NS 


2 


8C<.C?«* 


RfcL? 


NS 


X 


3820?1 


IMG2 


NS 


Y 


052001 


CCS 


£ 


I 


0Q3«^C 
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COMMANDS/MESSAGES 



This section describes MAP III system operator 
commands and console, dayfile, and error log mes- 
sages provided by MSSI. 



OPERATOR COMMANDS 



MAP,UNLOCK. 

Clears lock word in ECS. MAP, UNLOCK, may be 
required if an on-line diagnostic hangs after making 
MLOCK call. 



MAPINIT. 

n.XMAPINIT. (NOS/BE) 
X. MAPINIT. (NOS) 

Initializes MAP for user programs running on this 
computer, provided that MAP is operational and 
turned on in equipment status table (EST), and that 
MAP PP driver (MP3) is not already executing in 
this computer. 



MAP,DIAG. 

Schedules an on-line diagnostic for immediate 
execution. 



MAP,DIAG,XXXXX. 

Sets an on-line diagnostic execution interval to 
xxxxx- seconds. 



MAP, IDLE. 

Disables MSAM calls from user programs not hold- 
ing schedule table entries. Programs holding 
schedule table entries run to completion. After 
MAP, IDLE. , MSAM responds to METOPEN calls 
with MET code/status 221 R (requested equipment 
not available). 



8 



MAP.ABORT. 

Causes central processor (CP) monitor to ignore 
OPEN and EXECUTE functions, aborts user pro- 
grams having schedule table entries for this com- 
puter, and turns MAP off in EST. 



MAP,DOWN. 

Identifies MAP as nonoperational. After 
MAP, DOWN. , MSAM responds to MAPGO calls 
by sending 

MAP DOWN. TYPE GO OR DROP. 

to B display. MSSI returns MET code/status 217 
(MAP down) to jobs that had active schedule table 
entries when operator issued MAP, DOWN. 



MAP, UP. 

Identifies MAP as again being operational. 



MAP,CHECKPOINT. t 

Suspends processing of MAP jobs while leaving 
MAP logically on. MAP processing resumes when 
operator issues MAPINIT command. 



MAP, CLEAR, tf 

Clears active/inactive schedule table entries for 
other computer and clears MAP bits in ECS flag 
register. If macro string from other computer is 
executing, MAP, CLEAR, terminates this execution. 



MAP.NODUMP. 

Clears ECS dump interlock word. Since interlock 
word normally clears during end-of-job processing, 
use MAP, NODUMP. only when job that set interlock 
word is hung. 



MSSI CONSOLE MESSAGES 

The following messages may appear on the B dis- 
play, and in some cases, in user job dayfiles. 
Unless otherwise indicated, notify the system ana- 
lyst when one of these messages appears. 



Console Message /Description Routine /Command 

BAD CHANNEL XFER LOAD- MPI/MAPINIT 
ING CONTROL MEMORY 

Checkword error occurred or 
MAP did not respond after 
MPI loaded control and sub- 
control memory from PP 

channel. 



f NOS only. 
TtDual computer installation, NOS/BE only. 
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Console Message/Description Routine/Command 
CANT LOAD MAPLIB 



Console Message/Description Routine/Command 



Controlware not properly- 
structured. 

DRIVER REQUIRED FOR 
MAP CLEART 

MAP, CLEAR, command 
entered while MAP not in 
operation. 

ECS DUMP INTERLOCK WAS 
job/idtf 

Displays interlock word just 
cleared. 

job Job name. 

id - access A 
mainframe. 

1 - access B 
mainframe. 

ECS LOCK INTERLOCK WAS 
job/idtt 

Displays interlock word just 
cleared. 



job Job name. 

id - access A 
mainframe. 

1 - access B 
mainframe. 

FATAL MAP ERRORS 
LOADING CONTROLWARE 

Error detected in MAP status 
word during default control- 
ware load. 

FULL INITIALIZATION 

This computer controls MAP 
PP channel interface. MSSI 
has initialized ECS common 
area and loaded MAP with de- 
fault controlware. No action 
required. 

INTERLOCK = job/id/jdtf 

Displays interlock word just 
cleared. 

job Job name. 

id - access A 
mainframe. 

1 - access B 
mainframe 

jdt Job descriptor 
table ordinal. 



MAPINIT/ 
MAPINIT 



IMP /MAP, CLEAR. 



IMP/ 
MAP, NODUMP. 



IMP/MAP/ 
UNLOCK. 



MPI/MAPINIT 



MPI /MAPINIT 



IMP/ 
MAP, NODUMP. 

IMP/ 
MAP, UNLOCK. 



MAP CHANNEL ALREADY 
RESERVED 

MAPINIT command issued 
while MP3 active. 

MAP DOWNtT 

MSSI declared MAP non- 
operational. Notify cus- 
tomer engineer. 

MAP DOWN. TYPE GO OR 
DROP.T 

MSAM determined that MAP 
is nonoperational and sus- 
pended processing. To re- 
sume processing, verify 
that MAP is operational, type 
MAP, UP. , and type n. GO. 
To terminate processing, 
type n.DROP. 

MAP DUMP I/L - CYB (id) 
(jdt)t 

MAP DUMP IL - job id ft 

MP3 is waiting for dis- 
played job to clear ECS dump 
interlock word. Type 
MAP, NODUMP. if job 
appears hung. 



id 



jdt 



- access A 
mainframe. 

1 - access B 
mainframe. 

Job descriptor 
table ordinal. 



job Job name. 

MAP HUNG, STATUS 
RETURN ERROR 

MAP returned incomplete 
status or did not respond to 
status function. Notify cus- 
tomer engineer. 

MAP INITIALIZATION 
REQUIRED FOR ABORT f 

MAP, ABORT, command 
entered while MAP was not 
initialized. 

MAP INTERLOCK 

CP monitor cannot modify 
ECS flag register. Issue 
MAP, CLEAR, command. 



MPI/MAPINIT 



CP monitor 



MSAM 



MP3 



MPI 



IMP/MAP. ABORT. 



CP Monitor 



TNOS/BE only. 
ffNOS only. 
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Console Message/Description Routine /Command 



Console Message/Description Routine/Command 



MAP IS DISABLED OR NOT 
READY? 

Status received from MAP 
during initialization does not 
have ready bit set. 

MAP IS HUNG OR DOWN 

MAP does not respond or 
MAP returned error status 
in response to MAPINIT. 
command. Notify customer 
engineer. 

MAP IS NOT AVAILABLE 

CP monitor returned re- 
quested equipment not avail- 
able status during initializa- 
tion. Check MAP status in 
EST. 

MAP IS OFF 

MAP is turned off in EST. 
Turn MAP on and reenter 
MAPINIT command. 

MAP JOBS ARE 
CHECKPOINTEDt 

MAP jobs have been check- 
pointed in preparation for 
MSSI or system recovery. 

MAP NOT AVAILABLE. 
TYPE GO OR DROP. 

MSAM is attempting to open 
schedule table entry while 
MAP is turned off in EST, or 
MAP has not been initialized 
via MAPINIT command. 
Turn on MAP in EST and type 
n.GO, or enter MAPINIT and 
type n. GO, or type n. DROP. 

MAPGO(S) ISSUED AFTER 
MAP EXECUTION ERR 

MAPGO call issued while 
associated MET contained 
code/status 321 (fatal execu- 
tion error). 

MAPIII NOT INITIALIZED! 

MAP, command entered 

while MAP was not in 
operation. 

MAPINIT FIELD LENGTH 
OUT OF RANGE 

MAPINIT object code not 
properly structured. 



MPI/MAPINIT 



MPI /MAPINIT 



MAPINIT/ 
MAPINIT 



MPI/MAPINIT 



IMP/MAP, 
CHECKPOINT, 
or 

CHECKPOINT 
SYSTEM 

MSAM 



MSAM 



IMP 



MPI/MAPINIT 



MAP3-ECS I/O ERROR tt 

ECS failure occurred while 
MP3 was attempting to read 
or write. Notify customer 
engineer. 

MP3 ACTIVE 

MAPINIT command entered 
while MAP was already 
active. 

MPS ACTIVE BEFORE 
FUNCT XXXX 

MP3 found PP channel 
already active before issuing 
last function (XXXX). Notify 
customer engineer. 

MP3 CHECKWORD ERR 
XXXX 

MP3 received checkword 
error status from MAP. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 

MP3 EMPTY BEFORE 
INPUT XXXX 

MP3 found PP channel 
empty before attempting 
input. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 

MP3 FATAL MAP/SYSTEM 
ERR XXXX 

MAP unable to complete 
macro string normally for 
reason displayed in previous 
dayfile message. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 

MP3 FULL AFTER OUTPUT 
XXXX 

MAP failed to accept last 
word output to PP channel. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 



CP Monitor 



MPI/MAPINIT 



MP3 



MP3 



MP3 



MP3 



MP3 



tNOS only. 
TTNOS/BE only. 
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Console Message/Description Routine/Command Console Message /Description Routine /Command 



MP3 FULL BEFORE MP3 

OUTPUT XXXX 

MP3 found PP channel 
already full before output. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 

MP3 FUNCTION BUSY MP3 

TIMEOUT XXXX 

Function busy bit failed to 
drop from MAP status. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 

MP3 INPUT CHECKWORD MP3 

ERROR XXXX 

MP3 detected invalid input 
checkword for on-line diag- 
nostic PP channel transfer. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 

MP3 NO RESPONSE MP3 

FUNCTION XXXX 

PP channel failed to go in- 
active after MP3 issued 
function XXXX to MAP. 
Notify customer engineer. 

MP3 TIMEOUT ON INPUT MP3 

XXXX 

MP3 found PP channel in- 
active after IAM (block in- 
put) instruction. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 

MP3 TIMEOUT ON OUTPUT MP3 
XXXX 

MP3 found channel inactive 
after OAM (block output) 
instruction. 

XXXX was last function 
issued by MP3. Notify 
customer engineer. 

NO COMMON PARTITION MAPINIT/ 

FOUND IN ECS PARTITION MAPINIT 

TABLET 

MAPINIT did not find common 
ECS partition named COMMON. 
Check deadstart procedure. 



MP3 



NO DDPt 

Distributive data path (DDP) 
device not defined in EST or 
logically off. No dump 
produced. 

NO MAP ENTRY IN EST 

MAP not defined in EST. 

NO MAP EQUIPMENT 
PRESENT 

MAP not defined in EST. 

NOT ENOUGH ECS FOR 
MAP TAB LEST 

ECS common area too small 
for MAP tables. Check 
deadstart procedure. 

PARTIAL INITIALIZATION 

Other computer controls 
MAP PP channel interface. 
MSSI initialized only sched- 
ule table in ECS and did 
not reload MAP with control- 
ware. No action required. 

RECOVERY/FULL 
INITIALIZATION ft 

MSSI initialized. 

RECOVERY/PARTIAL 
INITIALIZATION TT 

MSSI recovered from ECS. 

REQUESTED CHANNEL NOT 
ASSIGNED - TRY AGAIN 

CP monitor error occurred 
while trying to reserve MAP 
PP channel. Try again. 

WAIT ACTIVE STE 

MAP. ABORT, command 
waiting for all schedule 
table entries to become 
inactive. 



WAITING FOR LOCKED MAP MSAM 

MAP locked by another on- 
line diagnostic job when this 
job issued MLOCK call. 
MAP will be locked for this 
job when current reservation 
released. 



MPI/MAPINIT 



IMP/MAP, IDLE. 



MAPINIT/ 
MAPINIT 



MPI/MAPINIT 



MPI/MAPINIT 



MPI/MAPINIT 



MPI/MAPINIT - 



IMP /MAP, ABORT. 



TNOS/BE only. 
TTNOS only. 
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Console Message/Description Routine/Command 



Dayfile Message/Description 



Routine 



WAITING FOR MAP IMP 

ACTIVITY? 

User program terminated be- 
fore MAP completed process- 
ing associated macro string. 
No operator action required. 

WAITING FOR SCHEDULE 
TABLE ENTRY MSAM 

Schedule table full when 
MSAM issued OPEN function. 
MSAM periodically tries 
again. No operator action 
required. 



1SO--SWAPOUT SUSPENDED 
BY MAP ACTIVITY - TRY 
LATERf 

Operator attempted to swap 
out MAP job via n. LOCKOUT, 
command. Swapout has not 
occurred because job is cur- 
rently using MAP or has 
locked MAP. If necessary 
to swap out job, operator 
must retry swapout later 
(system will not automatically 
retry swapout). 



MSSI DAYFILE MESSAGES 

Dayfile Message/Description 

DDP ERROR, NO DUMP 

DDP error occurred during MAP dump. 
No dump produced. 

DPxx, Cyy, PE, RNR, S0000, Azzzzzzzff 

DDP error occurred while writing 
MAP dump buffer to ECS. 



ISO/n. LOCKOUT 



xx 

yy 



DDP EST ordinal. 
DDP channel number. 



zzzzzzz ECS buffer address 
being written into. 

ERROR IN LIBRARY ECS XFER 

Error occurred while transferring 
controlware from central memory 
to ECS. Notify system analyst. 

ERROR IN LIBRARY LOAD 

MSAM detected error while loading 
controlware. Notify system analyst. 



Routine 



MP3 



MP3 



MSAM 



MSAM 



FATAL MAP ERROR, MACRO = nn MP3 

MP3 detected fatal error during macro 
string execution. 

JOB ABORTED. ERRORS DETECTED MSAM 

BY MSA M.- 
MS AM "fatal error limit exceeded. 

JOB ABORTED. MET CODE/ MSAM 

STATUS = nnn 

MET contains code /status that pre- 
cludes further processing. 

MAP DOWN. TYPE GO OR DROP. T MSAM 

MSAM determined that MAP is non- 
operational and suspended processing. 
To resume processing, verify that MAP 
is operational, type MAP, UP. , and type 
n. GO. To terminate processing, type 
n. DROP. 

MAP NOT AVAILABLE. TYPE GO OR MSAM 

DROP. 

MSAM attempting to open schedule table 
entry while MAP turned off in EST, or 
MAP has not been initialized via 
MAPINIT command. Turn on MAP in 
EST and type n. GO, or enter MAPINIT 
and type N. GO, or type n. DROP. 

MAP TIME LIMIT MP3 

Macro string execution time exceeded 
limit specified by MAPGO call or in- 
stallation parameter. 

MAPGO(S) ISSUED AFTER MAP MSAM 

EXECUTION ERR 

MAPGO call issued while associated 
MET contained code /status 321 (fatal 
execution error). 

MET FIELD O. R MP3 

MET central memory address out of 
range. 

MP3 ACTIVE BEFORE FUNCT XXXX MP3 

MP3 found PP channel already active 
before issuing last function (XXXX). 

MP3 BAD CHANNEL TRANSFER MP3 

REQUEST 

MP3 received unrecognizable PP chan- 
nel transfer request from an on-line 
diagnostic. 



tNOS/BE only. 
TtNOS only. 
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MAP failed to accept last word output 
to PP channel. 

XXXX was last function issued by MP3. 

MP3 FULL BEFORE OUTPUT XXXX 

MP3 found PP channel already full 
before output. 

XXXX was last function issued by MP3. 

MP3 FUNCTION BUSY TIMEOUT XXXX 

Function busy bit failed to drop from 
MAP status. 

XXXX was last function issued by MP3. 

MP3 INPUT CHECKWORD ERROR 
XXXX 

MP3 detected invalid input checkword 
for an on-line diagnostic PP channel 
transfer. 

XXXX was last function issued by MP3. 

MP3 NO RESPONSE FUNCTION XXXX 

PP channel failed to go inactive after 
MP3 issued function xxxx to MAP. 

MP3 TIMEOUT ON INPUT XXXX 

MP3 found PP channel inactive after 
IAM (block input) instruction. 

XXXX was last function issued by MP3. 

MP3 TIMEOUT ON OUTPUT XXXX 

MP3 found PP channel inactive after 
OAM (block output) instruction. 

XXXX was last function issued by MP3. 



Routine 



MP3 



MP3 



Dayfile Message /Desc ription 

MP3 CHECKWORD ERR XXXX 

MP3 received checkword error status 
from MAP. 

XXXX was last function issued by MP3. 

MP3 EMPTY BEFORE INPUT XXXX 

MP3 found PP channel empty before 
attempting input. 

XXXX was last function issued by MPS. 

MP3 FATAL MAP /SYSTEM ERR XXXX MP3 

MAP unable to complete macro string 
normally for reason displayed in pre- 
vious dayfile message. 

XXXX was last function issued by MP3. 
MP3 FULL AFTER OUTPUT XXXX 



MP3 



MP3 



MP3 



MP3 



MP3 



MP3 



MP3 



Dayfile Message/Description 

MSAM ARGUMENT COUNT ERROR 

DETECTED BY xxxxxxx 
CALLED FROM yyyyyyy LINE zzzz 

MSAM routine call had incorrect num- 
ber of parameters. 

xxxxxxx Name of routine that 

detected error. 

yyyyyyy Name of routine that 

called xxxxxxx. 

zzzz Call line number on 

yyyyyyy program 

listing. 
MSAM STATUS WORD = xxxxxxxxxx 

yyyyyyy 

Issued when MSAM aborts job. 

xxxxxxxxxx MSAM status word. 

yyyyyyy 



Routine 



MSAM 



MSAM 



Macro or MSAM rou- 
tine that triggered 
abort. 



NO DDPt 



MP3 



IMP 



DDP not defined in EST or logically 
off. No dump produced. 

OPERATOR MAP ABORTft 

Operator aborted MAP III system 
thereby aborting jobs with pending 
MAP requests. 



MSSI ERROR LOG MESSAGES tt 

When one of these messages appears, notify the 
customer engineer. 



Error Log Messa ge/Description 

DPxx, Cyy, PE. RNR, S0000, Azzzzzzz tt 

DDP error occurred while writing MAP 
dump buffer to ECS. 



xx DDP EST ordinal. 

yy DDP PP channel number. 

zzzzzzz ECS buffer address being 
written into. 



Routine 



MP3 



tNOS/BE only. 
ttNOS only. 
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Error Log Message /Description 

MPxx, Cyy, IS, EC, AAAA, BBBB, CCCC, 

DDDD 
MPxx, Cyy, 2S, EC, EEEE, FFFF, GGGG, 

HHHH 

MAP hardware error. 

xx MAP EST ordinal. 

MAP PP channel number. 



yy 
is 

2S 
EC 



Signifies this is first line 
of two-line message. 

Signifies this is second 
line of two-line message. 

MP3 error code. 

1 No response to 
function code. 

2 Fatal system/ 
MAP error. 

3 Checkword error. 

4 PP channel failed 
to go empty. 

5 Deadman timeout 
on input. 

6 Deadman timeout 
on output. 

7 PP channel full be- 
fore output. 

8 PP channel active 
before function. 

9 Timeout exceeded 
waiting for function 
busy to clear. 

10 PP channel empty 
before input. 



Routine 
MP3 
MP3 



Error Log Message /Description Routine 

AAAA MAP status word 0. 

BBBB MAP status word 1. 

CCCC MAP status word 2. 

DDDD MAP status word 3. 

EEEE MAP status word 4. 

FFFF MAP status word 5. 

GGGG MAP status word 6. 

HHHH MAP status word 7. 

MSSI CERFILE ENTRY FORMATt 

Figure 5-1 shows the format of the CERFILE entry 
made by MSSI for some MAP errors. 

Error codes for word 3, bits 48 through 53, and 
word 4, bits 48 through 59, are defined as follows: 



Error Code 

1 
2 
3 
4 
5 
6 
7 
8 
9 
10 



Definition 

No response to function. 
Fatal MAP /system error. 
Checkword error. 
Channel full after output. 
Timeout on channel output. 
Timeout on channel input. 
Channel full before output. 
Channel active before function. 
Function busy timeout. 
Channel empty before input. 



TNOS/BE only. 
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WORD 
1 


59 


SYSTEM-SUPPLIED TIME 







2 


59 


SYSTEM-SUPPLIED JOB NAME 







3 


59 


54 
37 8 


53 48 

ERROR 

CODE 


47 42 

EST 
ORDINAL 


41 36 35 30 
PP CHANNEL 
NUMBER NUMBER 


29 

RESERVED 







4 


59 


48 
ERROR 
CODE 


47 36 
RESERVED 


35 24 
PRIMARY 
STATUS 


23 12 

PROGRAMMED 

STATUS 


11 


MACRO 
MEMORY 
STATUS 





5 


59 
59 


CONTROL **' 
MEMORY 
STATUS 


47 36 

ARITHMETIC 

ERRORS 1 


35 24 
ARITHMETIC 
ERRORS 2 


23 12 
ARITHMETIC 
ERRORS 3 


11 


MEMORY 
ERRORS 





6 


12 
RESERVED 


11 


UNUSED 





7 


59 


UNUSED 







8 


59 


UNUSED 








Figure 5-1. MAP CERFILE Entry Format 
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MACRO PARAMETERS 



This appendix describes common types of macro 
parameters, describes the sine/cosine table used 
with FFT macros, and provides a parameter table 
for each macro that requires parameters. 



OFFSET (OFF) 

Number of data storage locations between first ele- 
ment of array and first element of array to be 
processed. 



PARAMETER DESCRIPTIONS 

The following paragraphs describe types of param- 
eters used with more than one macro. 



FIRST WORD ADDRESS (FWA) 

Specifies MAP data storage address to contain first 
element of array. 



FORMAT CONVERSION PARAMETERS 

Numerical conversion and assembly/disassembly 
units within MAP convert various external data for- 
mats to the MAP internal data format, and vice 
versa. These units extract the following four words 
from the parameters accompanying an input/output 
macro and use these words to perform the specified 
conversion. Table A-l lists format conversion 
parameter values for several external formats. 



INCREMENT FACTOR (IF) 

Determines spacing of array elements in MAP 
data storage. First element has address FWA and 
i th element <i=0, 1,2,...) has address FWA+i*(IF). 
IF must be an integer. Figure A-l shows array 
loaded into data storage with IF set to +2. 



Numerical Conversion Control (NCC) Word 

Identifies external format, specifies conversion 
direction, and provides for sign inversion or con- 
version disable. Figure A -2 shows bit fields in 
NCC word. 



Initial 
array vaLue 

Next 
array value 



Succeeding 
array values 




V///////////////77ZVZ 



Low addresses 



FWA-1 

FWA 
_ FWA+1 

FWA+3 
FWA+4 
FWA+5 
FWA+6 
. , FWA+7 

\///////////// / /// ZZ&— FW A + 8 

FWA+9 



w////// / /////// /zm 



V////////////////ZZZ. 



High addresses 



Figure A-l. +2 Increment Factor 



Radix Point Adjust (RPA) Word 

Contains 12 -bit twos complement number that is 
added to unbiased external exponent to adjust 
floating-point formats having radix point other than 
immediately to left of mantissa. RPA word can 
also be used to enable MAP to process numbers 
exceeding allowable MAP range. 

RPA word format is as follows: 

17 12 11 

| unused J RPA value j 

Appendix C contains instructions for using RPA 
word. 
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TABLE A-l. FORMAT CONVERSION PARAMETERS 



External 
Format 



CDC CYBER/ 
6000 32-bit 
floating point 



© 



Macro 



CDC CYBER/ 
6000 30-bit 
floating point 



<D 



CDC CYBER/ 
6000 32-bit 
fixed point 



© 



CDC CYBER/ © 
6000 30-bit 
fixed point 

MAP format: 
full 32 -bit 



LOADL32 
UNLDL32 



w 



NCC 
Word 



001604 
001404 



LOADP30 © 
UNLDP30 



LOADR32 
UNLDR32 



© 



UNLDP30 

LOADP32 
UNLDP32 



001604 
001404 



00023 7 
000037 



00003 7 

000340 
000140 



Value (T) 



RPA 
Word 



000060 
(48) 

007720 
(-48) 



000060 
(48) 

007720 
(-48) 



000037 
(31) 

000037 
(31) 



000037 
(31) 






Word 1 
Mask 



177777 
177777 



177776 

177777 



© 



177777 
177777 



© 



377777 

177777 
177777 



Word 2 
Mask 








® Decimal values are in parentheses; others are octal. 

(D Uses most significant 32 bits of 60-bit floating-point word (12 -bit exponent, 20-bit 
coefficient). 

(D Numbers exceeding allowable MAP range (refer to section 1) cause numerical con- 
version unit overflow errors. 

© Packs most significant 30 bits (12-bit exponent, 18-bit coefficient) of each of two 
60-bit floating-point words into one 60-bit word. 

(5) Allows sign fill in lower 2 bits. 

© Expects 32-bit signed integer in lower 32 bits of 60-bit word. 

@ Packs two 30-bit signed integers into one 60-bit word. 

® MAP does not accept 30-bit packed fixed-point data. 

© Bit 29 is highest-order R3 bit transferred to ECS. 
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17 



11 109 8 76 5 4 32 



Unused 



Invert Internal Sign 
(Internal -* External only) 



= Same sign 

1 = Invert sign 



Exponent Representation 

= Twos complement 

1 = Ones complement 



Exponent Bias 

= Unbiased exponent 

1 = Biased exponent 



Exponent Width Code (EWC) 



000 
001 
010 
011 
100 
101 
110 



111 



7- bit exponent 

8- bit exponent 

9-bit exponent 

10- bit exponent 

11- bit exponent 

Not used 

11-bit exponent 30-bit 

format (for internal -» 

external only) 

Fixed point 



Exponent Power Code (EPC) 

00 = Exponent power of 2 

01 = Exponent power of 4 

10 = Exponent power of 16 

11 = Fixed point 



Number Representation 

00 = Ones complement number 

01 = Twos complement number 

10 = Sign and magnitude 

11 = Disable conversion 



Conversion Direction 

= Internal — external 

1 = External -*■ internal 



Figure A-2. NCC Word 



Assembly/Disassembly (A/D) Mask Words 



Control register R3 in MAP A/D unit. R3 is 72-bit 
left-shift register used for buffering and format 
modification during MAP input/output operations. 
Figure A -3 shows A/D mask words. 

For mask bits through 15, mask bit n controls 
R3 bits 2n and 2n+l. Rules for bits through 15 
are: 

• Each 1 in word 2 mask enters 0's in con- 
trolled R3 bit positions. 

• Each in word 2 mask lets corresponding 
word 1 mask control R3 entry. 

• Each 1 in word 1 mask enters data in con- 
trolled R3 bit positions, providing corre- 
sponding word 2 mask bit is 0. 

• Each in word 1 mask enters sign in con- 
trolled R3 bit position, providing corre- 
sponding word 2 mask bit is 0. Sign is de- 
fined as higher-order bit of 2 R3 bits con- 
trolled by highest-order 1 in word 1 mask. 



Bits 16 and 17 of each mask, when taken together, 
form a 4-bit, half-pad count. MAP doubles this 
count to determine number of bit positions between 
R3 bit 31 and highest-order R3 bit (between bits 1 
and 31) to be transferred to ECS. 



DESTINATION LIST PARAMETERS 

LOADP32 and LOADL32 each can simultaneously 
transfer data to multiple MAP data storage buffers 
called destination lists. Parameters specify num- 
ber of destination lists, first location of first list, 
spacing of data words in lists, and spacing of lists 
in data storage. Figure A-4 shows destination list 
parameters for a three- list load. For a single -list 
load, list count and list increment factor parameter 
values should be 1 and 0, respectively. 
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17 16 15 







I 




, 


t 










17 16 15 







1 1 


, 


. 


♦ 











Word 1 mask 

Data /sign select bits 

Lower two bits of half pad count 

Word 2 mask 

Zero-fill/enable word 1 mask bits 
Upper two bits of half pad count 



Figure A-3. A/D Mask Words 



Order 


Parameter 


Decimal 
Value 


1 


First list FWA 


10l' 


2 


Data increment factor 


1 / 


3 


Data word count 


100' 


10 


List count 


••/ 


11 


List increment factor 


500 





101 

200 



601 
700 



1101 
1200 



Data 

storage 

addresses 

(decimal) 



Destination 
list 1 



Destination 
list 2 



Destination 
list 3 



Figure A-4. Destination List Parameters 



SINE/COSINE TABLES 

Each FFT macro requires both a sine table and a 
cosine table to be resident together in one section 
of MAP data storage. The tables must include 
sines /cosines for the angles: 

0, A, 2A. 3A, . . . , ir-A 

A 2tt/N 

N Number of points in series to be 
transferred 

Also, N is 2 where n is the level count parameter 
for each FFT macro. 



The user can conserve MAP data storage by- 
taking advantage of the sine/cosine symmetry » 
fcos(a)=sin(a+*/2)] to overlap the last half of the 
sine table and the first half of the cosine table as 
shown in figure A -5. 

Tables for large series can be used for smaller 
series by increasing the sine/cosine increment 
factor. For example, tables used for a 2048-point 
transform with an increment factor of +1 can be 
used for a 1024-point transform by setting the in- 
crement factor to +2. 



A-4 
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FWA of sine table-* 



Overlap- 



0=sin(0) 




l=sin(7r/2)=cos(0) 




sinCTZ-A) 


0=sin(?r)=cos{7r/2) 




cos(7T-A) 



♦FWA of cos ine table 



Figure A-5. Sine/Cosine Table Overlap 

PARAMETER TABLES 

Tables A -2 through A- 14 define parameters for the macros described in section 3. 

TABLE A-2. UPM /TMM PARAMETERS 



Order 


Parameter 


Description 


Notes 


1 


N 


UPM 
TMM 


Number of macro memory locations to be 
changed. 

Must be 1. 




2 


M address 


UPM 
TMM 


First macro memory location to be changed. 
Macro memory location to be tested. 


- 


3 


Value 


UPM 
TMM 


Update value. 
Test value. 


- 


4 


UPM flag 




Non- 
zero 


Replace contents of each location to be 
changed with update value. 

Add update value to contents of each location 
to be changed. 


® 


(T) UPM 


only; unused for 


TMM. 
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TABLE A -3. LOAD FROM ECS PARAMETERS 



Order 



2 
3 

4 
5 
6 
7 
8 



10 
11 



Parameter 



FWA of first 
list 

Data IF 

Data word 
count 

NCC word 

RPA word 

Word 1 mask 

Word 2 mask 

Relative ECS 
FWA 



Relative ECS 
limit address 



List count 
List IF 



Description 



First location of first destination list in data storage. 



Spacing of data words for all destination lists. 

Number of data words to be loaded into eac^ desti- 
nation list. 



Data format conversion words. Refer to table A-l 
for common values for these words. 



Relative ECS address which, when added to user's 
absolute ECS RA, specifies first 60-bit word of 
transfer. 

Relative ECS address which, when added to user's 
absolute ECS RA, specifies last legal 60-bit word of 
the transfer. Transfer may terminate before this 
address. 

Number of destination lists. 

Spacing of corresponding data words in adjacent 
destination lists. 



Notes 



© 

©© 
© 



© 
© 

©0 
©@© 



(p Refer to Destination List Parameters in this appendix. 
© Must be nonzero integer. 

(D If this value is to be changed by MODIFY call, user must observe restrictions listed in 
section 2. 

© Omit for LOADP30 and LOADR32 macros. 

© Must be positive integer. Address of word i in destination list j (i^O, i> 1) is 
(first list FWA) + (j-l) - (List IF)+ i • (Data IF). 
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TABLE A-4. UNLOAD TO ECS PARAMETERS 



Order 


Parameter 


Description 


Notes 


1 


FWA of unload 
list 


First MAP data storage location in list to be trans- 
ferred to ECS. 


- 


2 


Data IF 


Spacing of data words in unload list. 


© 


3 


Data word count 


Number of data words to be sent to ECS. 


© 


4 


NCC word 






- 


5 


RPA word 




Data format conversion words. Refer to table A-l 
for common values for these words. 


- 


6 


Word 1 mask 






- 


7 


Word 2 mask 






- 


8 


Relative ECS 

FWA 


Relative ECS address which, when added to user's 
absolute ECS RA, specifies first ECS location to 
receive 60-bit word from MAP. 


© 


9 


Relative ECS 
limit address 


Relative ECS address which, when added to user's 
absolute ECS RA, specifies last ECS location that 
can legally receive 60-bit word from MAP. Trans- 
fer may terminate before this address. 


© © 


(l) Must be nonzero integer. 




© Single word transfer from MAP to ECS is illegal. 




© If this value is to be changed by MODIFY call, user must observe restrictions listed in 
section 2. 


© ECS limit address must be at least one greater than desired limit and evenly divisible by 8. 



TABLE A-5. SUMPROD PARAMETERS 



Order 


Parameter 


Description 


Notes 


1 


A FWA 


Location of A Q in data storage (filter FWA). 


- 


2 


A IF 


Spacing of elements in (Aj) array. 


© 


3 


B FWA 


Location of B_ in data storage (trace FWA). 


- 


4 


B IF 


Spacing of elements in (Bj) array. 


© 


5 


C FWA 


Location of C Q in data storage. 


- 


6 


C IF 


Spacing of elements in (Cj) array. 


© 


7 


LA 


Number of elements in (Aj), LA> 10. 


- 


8 


LB 


Number of elements in (Bj), LB^LA. 


- 


9 


LC 


Number of elements in (Cj) array (number of results). 


- 


10 


s 


Enable convolution. 

1 Enable correlation. 


© 


11 


shift 


Initial shift of (Aj) array. 


© 


Q Positive integer. 






© MAP microcode chara 


cteristics require that rather than -1 be used to select cc 


>nvolution. 


© Positive, negative, or 


zero integer. 
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TABLE A-6. STKMOVE PARAMETERS 



Order 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 



11 



Parameter 



A FWA 
A IF 
B FWA 
B IF 
C FWA 
C IF 
Pad 
Pad 
LC 



Pad 



Description 



Location of A Q in data storage. 

Spacing of elements in (Aj) array. 

Location of B in data storage. 

Spacing of elements in (Bj) array. 

Location of C Q in data storage. 

Spacing of elements in (Cj) array. 

Zero. 

Zero. 

Number of elements in (Cj) array (number of results). 



Enable move. 
Enable stack. 



Zero. 



© Nonzero integer except as specified in following note. 

© for move operations. 

© Must be included to satisfy MAP microcode requirements. 



Notes 



© 
© 
®© 

© 
© 
© 



© 



TABLE A-7. CPLXFFT/ICPXFFT PARAMETERS 



Order 


Parameter 


Description 


Notes 


1 


R FWA 


Location of real part of first complex input point. 


© 


2 


I FWA 


Location of imaginary part of first complex input 
point. 


© 


3 


Level count 


Log 2 (N) where N is number of complex input points. 


© 


4 


FWA of sine 
table 


Location of first sine table entry. 


© 


5 


FWA of 
cosine table 


Location of first cosine table entry. 


© 


6 


Sine /cosine 
table IF 


Spacing between consecutive table entries. Same © © 
spacing must be used for both tables. 


© Before transform, arrays R and I contain real and imaginary parts, respectively, for N 
complex points of series to be transformed. Elements in both R and I arrays must be 
contiguous (implied increment factor of +1). After transform, arrays R and I contain real 
and imaginary parts, respectively, for complex points of transformed series. 


© For example, when 1024 complex points are being transformed, level count is 10. 


© Refer to Sine/Cosine Tables in this appendix. 


© Positive integer. 
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TABLE A-8. REALFFT PARAMETERS 



Order 


Parameter 


Description 


Notes 


1 


R FWA 


Location of first even-numbered real input point. 


© 


2 


I FWA 


Location of first odd -numbered real input point. 


© 


3 


Level count 


Log„(N) where N is number of real input points. 


© 


4 


FWA of sine 
table 


Location of first sine table entry. 


© 


5 


FWA of 
cosine table 


Location of first cosine table entry. 


© 


6 


Sine /cosine 
table IF 


Spacing between consecutive table entries. Same 
spacing must be used for both tables. 


©© 


® Before transform, array R contains even-numbered real input points and array I contains 
odd-numbered real input points. Elements in each of these arrays must be contiguous 
(implied increment factor of +1). Although initially arrays R and I each contain N/2 points, 
(N/2) + 1 contiguous locations must be allocated for storage of complex results. After 
transform, arrays R and I contain real and imaginary parts, respectively, for first 
(N/2) + 1 complex points of transformed series. 


@ For example, when 1024 real points are being transformed, level count is 10. 


® Refer to Sine/Cosine Tables in this appendix. 


Positive integer. 







TABLE A -9. INVRFFT PARAMETERS 




Order 


Parameter 


Description 


Notes 


1 
2 

3 

4 

5 
6 


R FWA 
I FWA 

Level count 

FWA of sine 
table 

FWA of 
cosine table 

Sine /cosine 
table IF 


Location of real part of first complex input point. 

Location of imaginary part of first complex input 
point. 

Log 2 (N) where N is number of real output points. 

Location of first sine table entry. 

Location of first cosine table entry. 

Spacing between consecutive table entries. Same 
spacing must be used for both tables. 


© 
© 

© 
© 

© 
®© 


® Before transform, arrays R and I contain real and imaginary parts, respectively, for first 
(N/2) + 1 complex points of series to be transformed. First and last imaginary parts must 
be zero. Elements in both R and I arrays must be contiguous (implied increment factor of 
+ 1). After transform, array R contains even-numbered real result points and array I con- 
tains odd -numbered real result points. 

@ For example, when 1024 real output values are expected, level count is 10. 

© Refer to Sine /Cosine Tables in this appendix, 

© Positive integer. 
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TABLE A- 10. FILTER PARAMETERS 



10 



11 



12 



13 



Order 


Parameter 


1 


r FWA 


2 


r IF 


3 


G FWA 


4 


G IF 


5 


F FWA 


6 


a FWA 


7 


Length MD 



ALPHA address 



Length MS 



MA 



IFSTABL flag 



IF SPIKE flag 



IANS 



Description 



Location of r Q in data storage. 

Spacing of elements in list for array r. . 

Location of G Q in data storage. 

Spacing of elements in array G.. 

Location of F Q in data storage. 

Location of a Q in data storage. 

Number of elements of arrays a. and F. to calculate. 
(Arrays rt and G. must each ha^e at least length MD 
elements.) 

First location in data storage of three-word buffer 
used by FILTER to calculate each element of array 
i' 

Word 1 Expected error for an aj array of 
length MA (parameter 10). 

Word 2 E operator for next element of array 

a., 
i 

Word 3 H operator for next element of array 

F.. 

l 

Element of arrays a. and F. at which" to start 
calculation. x 

Number of elements of arrays aj and F. calculated. 
(When array F is unstable or singular, 1 MA < length 
MD; otherwise; MA = length MD.) 

When IFSTABL flag is zero, it selects stability check 
on array F . If array F. is unstable, IANS address 
(parameter 13) contains 1 -!, and MA address contains 
number of stable elements in arrays a. and F.. 

When IFSPIKE flag is zero, it selects generation of 
array a. only; array G. is not required and array F. 
is not generated. 1 

When IFSPIKE flag is nonzero, FILTER requires 
array Gj and generates arrays a. and F.. 

FILTER macro status code. 

Normal return; MA = length MD. 

-1 Array F { unstable; MA < length MD. 

~ 2 Array F. singular; MA < length MD. 



Notes 



© 

© 
© 
© 
© 



© 
©© 

© 
© 

©© 



© Positive integer. 

(D FILTER stores elements of arrays a. and F. in consecutive data storage locations 
increment factor of +1). 1 1 

© Refer to FILTER description for more information. 

(4) Use MPARAM call to specify this common parameter for use by other macros. 

© When IFSTABL flag is zero and array F. is singular, IANS code is -1. 



(implied 
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TABLE A-ll. NMO PARAMETERS 



Order 


Parameter 


Description 


Notes 


1 

2 
3 

4 
5 
6 

7 
8 
9 


IN FWA 

V FWA 

OUT FWA 

N 

Kl 

K2 

K3 
K4 
BETA 


Location of first input trace sample. 

Location of first velocity function value. 

Location of first output trace sample. 

Number of input trace sample (N > 0). 

Starting value of velocity function index (Kl > 0). 

Preexecution Number of output trace samples to 
mute. 

Postexecution Number of output trace samples 
muted. 

Postexecution Index to first nonmuted output trace 
sample after sample identified by 
parameter K2. 

Number of samples to move per velocity function 
- sample (K4 = 1 for NMO and K4 > 1 for velocity 
analysis computation). 

Location of first parameter in BETA auxiliary array. 


© 

0© 

©0 
© 


Each value in this list must be squared inverse of velocity function value in distance/ 
millisecond units. 

NMO returns value to this macro memory location. Use MPARAM call to specify this 
common parameter for use by other macros. 

When nonzero upon entry, NMO interprets this value as number of output samples to mute. 

When input trace has already been muted beyond sample specified by K2 or THRESH, this 
value is index from last specified muted sample to first nonmuted output trace sample. 

BETA array contains following floating-point values. 

BETA (1) = T = time between input trace samples in milliseconds. 

(2) = TMAX = input trace last sample time in milliseconds. 

(3) = D = squared offset distance for this input trace. 

(4) = THRESH = front end mute parameter (refer to NMO description for use). 

(5) = Tj = velocity function first sample time in milliseconds. 

(6) = Tj = input trace first sample time in milliseconds. 

(7) = T rv = time between velocity function samples in milliseconds. 
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TABLE A-12. TYPE 1 PARAMETERS (T) 



Order 



1 

2 
3 
4 
5 
6 
7 
8 
9 



Parameter 



A FWA 
A OFF 
A IF 
LA 

D FWA 
D OFF 
D IF 
FLAG 
AU 



Description 



Location of A Q in data storage. 
Offset of array A. from A Q . 
Spacing of elements in array A .. 
Number of elements in arrays. 
Location of D. in data storage. 
Offset of array D. from D Q . 
Spacing of elements in array D.. 
Option flag. 
Arithmetic unit selection. 



(l) Following macros use this parameter block. 

CVEC NMVEC ZEROVEC 1 
NVEC SUMRVEC SQRTVEC J 
MVEC BCASVEC COMVEC J 

(D Refer to appropriate macro description for use of this parameter. 



TVEC 

XMM2DM 

XDM2MM 



TABLE A-13. .TYPE 2 PARAMETERS (T) 



Notes 



© 
© 



Order 


Parameter 


Description 


Notes 


1 




A FWA 


Location of A_ in data storage. 


- 


2 




A OFF 


Offset of array A . from A Q . 


- 


3 




A IF 


Spacing of elements in array A.. 


- 


4 




LA 


Number of elements in arrays. 


- 


5 




B FWA 


Location of B Q in data storage. 


- 


6 




B OFF 


Offset of array B. from B Q . 


-• 


7 




B IF 


Spacing of elements in array B.. 


- 


8 




D FWA 


Location of D Q in data storage. 


- 


9 




D OFF 


Offset of array D. from D_. 


- 


10 




D IF 


Spacing of elements in array D.. 


- 


11 




FLAG 


Option flag. 


© 


12 




AU 


Arithmetic unit selection. 


© 


Q Following macros use this parameter block. 






ADDVEC IPVEC 
SUBVEC MAXE 
MULVEC MINE 
DIVVEC 




(D Refer to appropriate macro description for use of this parameter. 
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TABLE A- 14. TYPE 3 PARAMETERS Q 



Order 


Parameter 


Description 


Notes 


1 


A FWA 


Location of A Q in data storage. 


- 


2 


A OFF 


Offset of array A . from A„. 
J 3 


- 


3 


A IF 


Spacing of elements in array A.. 


- 


4 


LA 


Number of elements in arrays. 


- 


5 


B FWA 


Location of B- in data storage. 


- 


6 


B OFF 


Offset of array B. from B Q . 


- 


7 


B IF 


Spacing of elements in array B.. 


- 


8 


C FWA 


Location of C in data storage. 


- 


9 


C OFF 


Offset of array C. from C Q . 


- 


10 


C IF 


Spacing of elements in array C 


- 


11 


D FWA 


Location of D- in data storage. 


- 


12 


D OFF 


Offset of array D. from D . 


- 


13 


D IF 


Spacing of elements in array D.. 


- 


14 


FLAG 


Option flag. 


(D 


15 


AU 


Arithmetic unit selection. 


© 


@ Following macros use 


this parameter block. 




MAWS 
MAVSV 
MAVVV 






(z) Refer to appropriate macro description for use of this parameter. 
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MSAM CALL/MACRO SUMMARIES 



B 



Table B-l summarizes macros available with the MAP III system. The following list shows MSAM call 
sequences. 

CALL METOPEN(met, symtable, controlware, conaddr, status! , errlim] ) 

CALL MAPSET(met, macbuf, length, status) 

CALL MALLOT(met, aryname, maplen, 0, mem, status) 

CALL MEQUIV(met, equivname, maplen, basearray, offset, status) 

CALL MACRO(macstr, tag, macname, paraddr, status) 

CALL MFARAM(macstr, tag, value, length, status[, loc]) 

CALL MAPNOGO(met, macstr, statusf, ref|) 

CALL MAPGO(met, macstr, timtable, errtable, recall, estime, statusf, febits]) 

CALL MODIFY(macstr, loc, value, status) 

CALL MCLOSE(met, status) 

CALL MRECALL{met, status) 

CALL MRESET{met, status) 

CALL MDUMP(x, y. z, c ) 

CALL MDRLSE 











TABLE E 


1- 1 . MAC RO S UM MAR Y 




Category 


Group 


Macro 


Octal 

Macro 

Code 


Name 


Parameter 
Table 






NOOP 




N/A 


No operation 


N/A 






JUMP 




N/A 


Jump 


N/A 






RJUMP 


© 


N/A 


Return jump 


N/A • 






HALT 




N/A 


Halt 


. N/A 


Control/ 


Standard 


END 




N/A 


Terminate macro execution 


N/A 


pseud o 




UPM 


31 


Update parameter 


A-2 






TMM 


32 


Test macro memory 


A-2 






XMM2DM 


54 


Transfer macro memory to data storage 


A-12 






XDM2MM 


54 


Transfer data storage to macro memory 


A-12 






LOADP32 


20 


Load packed 32 -bit words from ECS 


A -3 




^ 


UNLDP32 


24 


Unload packed 32 -bit words to ECS 


A-4 






LOADP30 


21 


Load packed 30-bit words from ECS 


A-3 


ECS 
input/ 


Standard 


UNLDP30 


25 


Unload packed 30 -bit words to ECS 


A-4 


output 




LOADL32 


22 


Load left-justified 32 -bit words from ECS 


A-3 






UNLDL32 


26 


Unload left -justified 32 -bit words to ECS 


A-4 






LOADR32 


23 


Load right -justified 32 -bit words from ECS 


A-3 






UNLDR32 


27 j 


Unload right-justified 32-bit words to ECS 


A-4 


(^ These i 
ware cl 


nacros execul 
tanges. 


:e from th 


e re 


ad -only s 


section of control memory and are not affected 


by control- 
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TABLE B-l. 


MACRO SUMMARY (Contd) 










Octal 






Category 


Group 


Macro 


Macro 
Code 


Name 


Parameter 
Table 




Signal 
processing 


SUMPROD 
STKMOVE 


00 

01 


Sum of products 
Stack /move 


A-5 

A-6 


Fast 
Fourier 


CPLXFFT 


04 


Complex fast Fourier transform 


A-7 




ICPXFFT 


05 


Inverse complex fast Fourier transform 


A-7 




transform 


REALFFT 


02 


Real fast Fourier transform 


A-8 






INVRFFT 


03 


Inverse real fast Fourier transform 


A-9 


Signal 
processing 


FILTER 
NMO 


07 
33 


Filter design 
Normal moveout 


A-10 
A-11 




CVEC 


40 


Copy vector 


A-12 






NVEC 


40 


Negate vector 


A-12 






MVEC 


40 


Magnitude vector 


A-12 






NMVEC 


40 


Negative magnitude vector 


A-12 






ADDVEC 


41 


Add vectors 


A-13 


Arithmetic 




SUBVEC 


41 


Subtract vectors 


A-13 






MULVEC 


41 


Multiply vectors 


A-13 






DIVV^EC 


41 


Divide vectors 


A-13 




Vector 


IPVEC 
SUMRVEC 


42 
43 


Inner product vectors 
Sum reduction 


A-13 
, A-12 






BCASVEC 


44 


Broadcast scalar 


A-12 






ZEROVEC 


44 


Zero array 


A-12 






MAXE 


45 


MAX elements 


A-13 






MINE 


45 


MIN elements 


A-13 






SQRTVEC 


46 


Vector square root 


A-12 






COMVEC 


47 


Compare vectors 


A-12 






MAWS 


52 


Multiply add vector, vector, scalar 


A-14 • 






MAVSV 


52 


Multiply add vector, scalar, vector 


A-14 






MAVVV 


52 


Multiply add vector, vector, vector 


A-14 


1 




TV EC 


53 


Pretruncate vector 


A-12 



B-2 
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MAP RADIX POINT ADJUST WORD 



This appendix contains a detailed explanation of how 
to use the radix point adjust (RPA) word parameter 
for MAP floating-point ECS I/O operations. The 
term radix point is a general version of the more 
specific binary point and the more well-known deci- 
mal point. 



COMPARISON OF CDC CYBER AND MAP 
FLOATING POINT FORMATS 

Let F = EMMMM be a CDC CYBER floating-point 
number with E denoting the 12 -bit sign-and- 
exponent byte and MMMM the 4 bytes of mantissa. 
The mantissa is considered to be a 48 -bit integer 
MMMM. between and 2 48 -l. That is, the radix 
point is at the right or least-significant -bit end of 
the mantissa. The integer mantissa, when multi- 
plied by 2 raised to the power represented by E, 
yields the floating-point number represented by 
EMMMM. Now let f = emmm be a MAP floating- 
point number with e denoting the 8-bit sign-and- 
exponent byte and mmm the 3 bytes of mantissa. 
The mantissa is considered to be a 24^-bit positive 
fraction less than 1. That is, the radix point is at 
the left or most-significant -bit end of the mantissa. 
The fractional mantissa, when multiplied by 2 
raised to the power represented by e, yields the 
floating-point number represented by emmm. 



NORMAL RPA USE FOR LOADING DATA 

Unless the MAP is informed otherwise, it assumes 
that each number it loads has a fractional mantissa. 
In particular, EMMMM is treated as the fraction 
0. MMMM times 2 raised to the power represented 
by E. This amounts to dividing the number that 
EMMMM represents by 2 48 during the loading pro- 
cess. Since the MAP adds the RPA value to the 
exponent of the external number during loading, 
this division by 2 48 can be compensated for by 
specifying RPA = 48 (=60.) to request multiplication 
by 24o. 8 



USING RPA FOR LOADING SCALED DATA 

If data to be loaded is outside the range of numbers 
representable in the MAP {approximately, numbers 
with absolute value between 10~ 19 and 10 +1 °), or if 
it is suspected that operations performed on data in 
that range will produce results out of that range, 
portions of the data should be altered by scaling 
during the loading process. As RPA = 48 multiplies 
data by 2 48 to compensate for the difference be- 
tween the CDC CYBER and MAP radix point con- 
ventions, external data may be transferred to the 



MAP multiplied by 2 n by using RPA = 48+n. For 
example, RPA = 48+10 = 72„ multiplies input by 
1024 and RPA = 48-10 = 46 8 divides input by 1024. 
Since RPA is a 12-bit two's complement value, 
special care may be necessary if 48+n is negative. 
For instance, multiplication by 2~ 49 during a load 
requires RPA = 48-49= -1 = 7777g. This is not a 
12 -bit representation of 0. 



USING RPA FOR UNLOADING DATA 

The general rule is that if MAP internal data is to 
be unloaded with some radix point adjustment, use 
the two's complement (negative) of the RPA value 
used to load the unloaded numbers back into the 
MAP exactly as they were. To unload standard 
MAP numbers into standard CDC CYBER format 
with no scaling, use the two's complement of 60s 
( = 77178 + 1 = 7720g) since 60s is the no scaling RPA 
for loading. To divide the numbers by 1024 on the 
way out of the MAP, use RPA = 7706g which is the 
two's complement of 72g. Similarly, multiplication 
by 1024 during unloads requires RPA = 7732„. 



TYPICAL EXAMPLE OF SCALING 

Suppose a macro string is to be constructed for the 
task of computing the autocorrelation of a sequence 
Tq.Tj,. ...Tggg, where the terms in the sequence 
are all in the range 10° to 10 10 . The terms 
Aq, Aj, . . . , Aggg of the resulting sequence are de- 



fined by 



999-k 

2 
i=0 



l k+i 



Each A- value is a sum of up to 1000 numbers in the 
range lO 1 " to 10 20 , and so must be in the range 
1016 to 10 23 . This only partially overlaps the 
upper range of the MAP. One solution would be to 
load the sequence tQ, tj, . . . , tggg defined by 
tj = Ti/1024. Then the SUMPROD macro for the 
autocorrelation would produce the result sequence 



a ,a l' 



■ a ggg defined by: 



999-k 

S t. t 
i=0 



k+i 



= (1024)" 



999-k 

2 
i=0 



T. T, J _. 

i k+i 



o pi 

Since Afc = (1024) a^ (approximately 10 a^) for each 
k, the a-values are in or slightly below the range 
10l0 to 10l7. The correctly scaled A-values can 
then be unloaded to ECS by unloading the a-values 
multiplied by 2 20 . Therefore, one loads the 
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C-l 



T-values with an RPA of 60g-12g = 46 8 and unloads 
the autocorrelation results with an RPA of 
-(60 8 -24 8 ) = -34 8 = 7743 8 +l = 7744 8 . Any possi- 
bilities of arithmetic unit overflow are thereby 
avoided. Underflow problems can be handled 
similarly. 

GENERAL REMARKS ON USING RPA WORD 

Two cautionary remarks should be made at this 
point. First, overcompensate by scaling if the 
range of the data to be loaded is not known exactly. 



Second, think very carefully about what will happen 
to the data inside the MAP. Theoretically follow 
through the entire requested MAP procedure (as 
in the previous example) to ensure that the chosen 
scaling of loaded data will not produce any unwanted 
underflows or overflows for intermediate results, 
and also to determine what scaling factor to use 
for unloading the final results. 



C-2 
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